Frequently Asked Questions
- Do I need an account to use your API?
- How can I access my account?
- What is the creditor reference?
- What is an entity?
- What is the subscriber reference?
- What are the supported currencies?
- What are the supported payment schemes?
- What are the countries we accept payments from?
1. Do I need an account to use your API?
Yes. There are three different types of account:
- The evaluation account can be created online for free to evaluate our solution. This account comes with a web API access.
- The UAT account is created by SlimPay and configured to fit your specific needs so you can test real life situations before going live.
- The live account is created by SlimPay once:
- You complete your tests
- Your tests are accepted by SlimPay
- You complete the KYC process
Note: the evaluation account may be automatically deleted after a certain period of time while your UAT account will stay untouched even after you go live.
2. How can I access my account?
Your SlimPay account is accessible via three different interfaces:
- A User Interface which is our dashboard, also known as back office.
- A web Application Programming Interface (web API).
- A file Application Programming Interface (file API).
Each interface has its own authentication mechanism and credential format.
- Login and password for the dashboard. This is provided by SlimPay.
- App ID and secret for the web API authentication.
- Public key for the file API connection.
3. What is the creditor reference?
The creditor reference is the unique identifier of your SlimPay account in our system.
4. What is an entity?
If your company holds one or more subsidiaries, you may want your payment flow to be divided by legal entity. Each entity will have its own reference in our system which has to be communicated along with the creditor reference already representing the holding company.
5. What is the subscriber reference?
We still offer a very basic, yet powerful payment-to-customer relation via the subscriber reference parameter. This value must be provided by you and it should be unique per customer.
Even if you allow guests to pay in your application, you need to provide it. In this case, you can generate a random unique identifier to insure the same reference is never used twice for two different guests.
You will find this reference when looking for mandates, payments and other reportings to help you link data in our system to data in your system.
6. What are the supported currencies?
7. What are the supported payment schemes?
A payment scheme is a set of rules and technical standards for the execution of payment transactions that have to be followed by adhering payment service providers.
As a Payment Service Provider, SlimPay supports the following schemes:
8. What are the countries we accept payments from?
As a SEPA schemes adherent, we accept payments from all the countries which are part of the SEPA jurisdictional scope. See the Map of SEPA Scheme Countries and Territories from the EPC.
On top of accepting payments in euro from the United Kingdoms, we accept payments in pound via their local scheme: BACS.