Before you can begin to create a mandate or add Direct Debit payments, you must first decide on the payment scheme that you want to use.
If you intend to process EUR payments and your customers are not other businesses or corporate entities, then you’d process through the SEPA CORE scheme. If you intend to conduct business with other corporates then the B2B scheme may be appropriate. If you are just interested in GBP payments then you will need to generate your mandates and collect payments through the Bacs scheme.
Each scheme has its own distinct requirements. So, for example, in B2B there are no refunds possible after 3 business days; for SEPA CORE, payers can request a no-questions-asked refund up to 8 weeks after the inital debit. In Bacs a refund is only possible in very specific cases.
In SEPA your business is identified through a Creditor Scheme Identifier (CSID), in Bacs this identifier is referred to as the Service User Number (SUN).
To decide on what scheme best suits your business, please discuss your requirements with your account manager who will be happy to assist.
|A member of the Nuapay Customer Support team will configure your CSID or SUN for you on both the Sandbox and Production environments.|
Using the Scheme in the API
In terms of interacting with the various Mandate and Direct Debit API services, the scheme you use is essential as it is the foundation on which all requests are built.
As outlined in the General API Rules section, the CSID or SUN is referenced in the URI where, for example, you:
- Create a mandate via a POST request:
abxq9kq52lis the resource identifier of the scheme in this example)
- Retrieve a Direct Debit through a GET
/schemes/abxq9kq52l/mandates/rtsxq8kaby5/directdebits/eshw2137gfc(in this case
rtsxq8kaby5is the mandate identifier;
eshw2137gfcis the Direct Debit transaction identifier)