You're viewing documentation for our latest API. This will not impact your integration, but you will need the documentation relevant to you. If you have an account with Checkout.com you have received an email confirming which version to use.
You can use the sandbox environment to simulate transaction flows with an issued card prior to going live. The sandbox environment enables you to run transactions without making any real purchases whilst retaining the same merchant and card network experience.
This enables you to test declined transactions because of a revoked card or lack of funds, reversals, refunds, and webhooks. Whilst running the test transactions, your issuing balance will be updated so that you can see how these simulations also impact your sandbox balance.
Whilst you can simulate transactions directly from the Dashboard, to simulate transactions using the API, follow these steps:
Locate the card you want to simulate transactions by navigating to Card Issuing > Cards, and then select the card. Alternatively, to simulate a transaction from the transactions list, navigate to Cards Issuing, then Transactions; you will require a card ID.
Click Simulate transaction in the top right corner.
Define the transaction details, such as amount and merchant category code, then click Simulate.
Once authorization is successfully simulated, you can also add events.
From the transaction details page, click Add event in the top right corner.
Choose the event type and amount, then click Simulate.
If the reversal amount is lower than the previously authorized amount, then only a portion of the authorized amount will be reversed. If the reversal amount is not specified, the full authorization amount will be reversed.
The status field returns Reversed if the reversal was successful, or Declined if not.
Reversal may be unsuccessful if the reversal amount is greater than the previously authorized amount, or if the authorization has already been cleared.
If the presentment amount is lower than the previously authorized amount, then only a portion of the authorized amount will be cleared. If the presentment amount is not specified, the full authorization amount will be cleared.
If the refund amount is lower than the previously cleared amount, only a portion of the cleared amount will be refunded. If the refund amount is not specified, the full cleared amount will be refunded.