Sandbox environment
Use sandbox mode to test your integration in sandbox environment before going live.
Sandbox environment is a specially designed testing ground for you to test your integration without making actual transactions. This environment is an integral part of our API, offering a safe and isolated space where you can rigorously test the integration of our invoice financing services within your platform.
To make sure that your integration works correctly, you are provided a isolated Sandbox base URL along with a comprehensive set of mock responses, meticulously crafted to simulate a wide range of real-world scenarios. These responses are triggered by predefined input values, allowing you to explore and understand the behavior of our various API endpoints in detail.
Whether you're aiming to validate basic functionalities, stress-test your application under various conditions, or ensure seamless user experiences, our Sandbox model is tailored to support all phases of your development process. By leveraging this environment, you can confidently fine-tune your integration, ensuring that it meets both your needs and the high standards of our platform, before going live.
Before you begin
- It is important that you use the base URL for the sandbox environment when calling API endpoints to prevent making actual transactions in the live environment
- Obtain your access token to the sandbox environment by authenticating to Stenn using your unique Client ID and Client Secret assigned to your sandbox environment. You will need the access token to make API calls.
- Ensure that our webhook endpoint is configured for your Sandbox environment in order to receive simulated webhook events.
Testing buyer limit requests
Simulate buyer limit requests by using the following special values in sandbox mode. Each special value will simulate its respective behavior as follow:
| DUNS | Behaviour |
|---|---|
| Any DUNS, including the special values | The buyer limit request is under review. The buyer limit request status will transition to under_reviewand a buyer_limit.under_review webhook event will be sent. |
| 400000000 | The buyer limit request is declined. The buyer limit request status will transition to declinedand a buyer_limit.declined webhook event will be sent. |
| 500000000 | The buyer limit request is approved. The buyer limit request status will transition to approvedand a buyer_limit.approved webhook event will be sent. |
| 600000000 | The buyer limit request requires additional documents to proceed. The buyer limit request status will transition to additional_info_requiredand a buyer_limit.additional_info_required webhook event will be sent. |
| 700000000 | The existing approved buyer limit is expired. The buyer limit request status will transition to expiredand a buyer_limit.expired webhook event will be sent. |
Testing financing sessions
Simulate invoice financing sessions by using the following special values in sandbox mode. Each special value will simulate its respective behavior as follow:
| Submitted By | Invoice Number | Behaviour |
|---|---|---|
| Any email besides the special values | Any invoice number besides the special values | New financing session is created. Redirect to the session_url returned to a Stenn-hosted web form to complete invoice financing application.An invoice.new webhook event will be sent when the form is submitted |
| [email protected] | INV1111 | The financing request requires additional documents to proceed. The invoice status will transition to additional_info_required. invoice.additional_info_required and invoice.financing.session.completedwebhook events will be sent. |
| [email protected] | INV2222 | The financing request is declined. The invoice status will transition to declined. invoice.declined and invoice.financing.session.completed webhook events will be sent. |
| [email protected] | INV3333 | The financing request requires signatures to proceed. The invoice status will transition to requesting_signatures. invoice.requesting_signaturesand invoice.financing.session.completed webhook events will be sent. |
| [email protected] | INV4444 | The financing request is approved. The invoice status will transition to approved. invoice.approved and invoice.financing.session.completed webhook events will be sent. |
| [email protected] | INV5555 | The financing request is financed. The invoice status will transition to financed. invoice.financed and invoice.financing.session.completed webhook events will be sent. |
| [email protected] | INV6666 | The financing is repaid. The invoice status will transition to repaid. invoice.repaid and invoice.financing.session.completed webhook events will be sent. |
Simulate cancelling and expiring of invoice financing sessions by using the following special values in sandbox mode. Each special value will simulate its respective behavior as follow:
| Submitted By | Behaviour | Redirect to session URL |
|---|---|---|
| [email protected] | The financing session is cancelled.invoice.financing.session.canceled webhook event will be sent.No invoice related webhook event will be sent. | Return canceled/expired session |
| [email protected] | The financing session is expired.invoice.financing.session.expired webhook event will be sent.No invoice related webhook event will be sent. | Return canceled/expired sessio |
Updated 5 months ago