Before reading this section please refer to the guide on how to Make your first loan in 5 minutes
Summary
Good testing test success and error cases.
So, we help you decide on the behavior of our sandbox: if it should work fine or produce errors.
Basically, it works this way:
- The Sandbox refers to IBAN that you use as the target account to pay
- We provide some testing scenarios: see Available testing scenarios below
- If you use an IBAN that you generated, we will use the SUCCESS scenario (it is the default scenario)
- To simulate other behaviors, we provide an IBAN generator at GET /sandbox/iban-generator ➜ select the scenario and we'll generate an IBAN for this scenario
An IBAN can be used with only one of your counterparties!
An IBAN can be used with only one of your counterparties. For example, you cannot use the same IBAN with two of your sellers. In such a case, you will have to generate two IBANs.
However, you can assign as many IBANs as you want to a single counterparty. So, you can test as many scenarios as you want against a single counterparty.
Obtaining an IBAN or more complex testing data
We provide three generators:
- An IBAN generator (GET /sandbox/iban-generator). By using the generated IBAN, you can generate new invoices by yourself.
- A business generator (GET /sandbox/business-generator). You can use the returned data to create a borrower.
- An invoice generator (POST /sandbox/invoice-generator) that generates both the IBAN and invoice for you. It enables you to test scenarios very quickly but gives you fewer control on the values of the invoice such as its amount, dates and so on.
Available testing scenarios
Scenario name | Description |
---|---|
SUCCESS | Successfully creates a loan that will be payed immediately after your approval. The credit transfer repayment will be triggered immediately after the payment. |
SUCCESS_ONE_DAY_LATER | Successfully creates a loan that will be paid immediately after your approval. The credit transfer repayment will be triggered the following day after the payment. |
REJECT (coming soon) | Creates a loan that will be declined by Defacto. |
FAIL | Creates a loan which payment will fail after your approval. |
Values for your very first tests
Before using the generators, you can use the test values below.
The effects on invoice/loan payments described in the table below are representative of the sandbox environment.
IBAN Number | Description | Example PDF Invoice | PDF base64 value |
---|---|---|---|
FR8811111015593603018280926 | Successfully creates a loan that will be payed immediately after your approval. The credit transfer repayment will be triggered immediately after the payment. | Success | Get here |
FR3711111025593244332331294 | Successfully creates a loan that will be paid immediately after your approval. The credit transfer repayment will be triggered the following day after the payment. | Repay One Day Later | Get here |
FR1311111045594746737398900 | Creates a loan which payment will fail after your approval. | Failed | Get here |