Start here first: read this guide before continuing
Read first the guide on how to Make your first loan in 5 minutes
Summary
Good testing reviews success and error cases.
So, we help you to decide on the behavior of our sandbox - should it work fine or produce errors?
How it works:
- 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, business or invoice for testing
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.
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 |
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 | Creates a loan that will be declined by Defacto, because of high risk probability. Loan status will be turned to DECLINED. |
| FAIL | Creates a loan which payment will fail after your approval. |