Prepare a subscription

Prev Next

Mary Evans, Cloud Kicks' accountant, is preparing a subscription for direct debit with Frisbii Pay today.

Generate a direct debit link

As described under Frisbii Pay recurring: Generate a payment link, a direct debit link must first be generated in the account so that Salesforce can automatically retrieve the bank details required for the direct debit.

  1. Click on the Generate direct debit link button in the account. The link is saved in the Direct Debit link field (sofactoapp__DirectDebitLink__c).  

  2. Send this link to your customer using our email template.

  3. After clicking on this direct debit link, your customer will be asked to enter the bank details for the direct debit collection of your invoices.  

  4. Once the customer has completed the form, a PSP payment method record is automatically created.

Linda, the Salesforce administrator, adds the related PSP Payment Method list to the account page layout. Mary can now view all PSP payment methods associated with this account.

The PSP payment method is a new object in our application for storing your customer's bank details.
The information for a recurring credit card is stored here:
 
As you can see, the credit card numbers are encrypted and the CVV is not accessible.

The information for a SEPA direct debit is stored here:

All fields relating to the PSP payment method cannot be changed.
Only the “Status: Active / Inactive” field can be changed.

Use case: Your customer changes banks next month. You send them a new direct debit authorization (by clicking on Generate direct debit link). Their account will consist of two PSP payment method records.
The following month, you can select Inactive for the first PSP payment method and Active for the second PSP payment method that will be used for direct debit.

You can now create a subscription with this payment method.

Create a subscription using the new payment method

Linda will first configure the page layouts.

These are the fields for the subscription, invoice and payment objects:

  • Payment Date (sofactoapp__PaymentDate__c), which stores the calculation of the debit date on the invoice.

  • PSP payment method

These fields must also be added for the invoice and payment objects:

  • Transaction ID (sofactoapp__TransactionId__c) > FrisbiiPay ID

  • Payment Status (sofactoapp__PaymentStatus__c)

Mary will now prepare her subscription for the new payment method.

Steps

  1. Create a subscription: It can be created ex nihilo (example in the article), from a closed won opportunity or from an offer that is in the Won phase.

  2. Add one or more subscription items.

  3. Specify the payment deadline and, above all, the payment method. Select Frisbii Pay Recurring for the subscriptions to be debited. The fields “PSP payment method” and “Payment day” appear dynamically.
     
    These fields are mandatory in order to link the payment information to the direct debit procedure for subscription invoices.
    > PSP payment method: is used to debit your invoices. In other words, it is the bank details that will be used to debit your invoices. Please note: In this drop-down list, you will only find PSPs whose status is “Active” and only for the account associated with this subscription.
    > Debit date: The values to be entered range from 1 to 31. For months that do not end on the 31st, the direct debit procedure is automatically switched to the following month. Example: Direct debit on March 1, not February 31.

  4. Activate the subscription and create an invoice schedule.

Observation: You will see in the invoices created:

  • The payment method Frisbii Pay Recurring

  • The PSP payment method

  • The payment date: The date is automatically calculated for all invoices in my schedule, based on the invoice date.

Example: on invoice M+2, the debit date corresponds to the 5th of the month M+2.

Invoices automatically have an associated payment record with a Frisbii PayRecurring payment method.

Important: Frisbii Pay Recurring is not compatible with a payment plan.

If you change the payment method of an invoice with a payment plan to Frisbii Pay Recurring,

(1) The outstanding payment records are deleted.

(2) A single payment record is created corresponding to the balance of the invoice.

Note: Since Winter '25, recurring payments are compatible with a payment schedule.

Installment payments will be debited on the date corresponding to their milestone.

  1. You generate a payment schedule from Invoice.

  2. The Debit date field on Invoice and Payment is cleared (sofactoapp__PaymentDate__c).

  3. The debit will be made on the Payment/Milestone date: