Testing
Test card generator
You can use our Test card generator and API Reference to create payments and receive responses based on your selected test scenarios. You can use our API Explorer to test your integration. Testing is available only in pre-production. To activate our advanced Card-based Payment Testing Simulator on your merchant ID, contact our boarding team.
To validate your integration, you can select the card payment product you want to test as well as the outcome of the test case you want to validate. Based on your selection, you will receive a card number and additional details you can put in your API request.
Follow these simple steps to start testing:
- Select payment product for which you want to generate test data. Test data is only available for payment products configured with your merchant ID.
- Select issuing country. This shows the card issuer's country where the account is registered, which determines 3D Secure usage. If your country isn't listed, select one from the same region (in brackets) for similar payment processing behavior.
- Specify card type. Card types are distinguished based on their features and usage. These types determine the card's functionality, such as the processing flow or associated benefits. System will automatically choose the default value if no selection is made.
- Select co-badged scenario if required. Co-badged cards feature several payment brands, allowing acceptance through the networks of each brand and increasing versatility.
- This field will be enabled or disabled for selection depending on the payment product chosen.
- Choose a 3D Secure & Strong Customer Authentication (SCA) testing scenario. This enhances online card transaction security with additional verification steps:
- Authentication type: Indicates the 3D Secure process, where the issuer may request additional data from the consumer during transactions.
- Authentication result: Shows the issuer's authentication level, affecting liability and next steps.
- Exemption result: Indicates if a transaction can skip extra authentication steps in 3D Secure based on its risk assessment.
- Select fraud management testing scenario:
- CVV result: Response from the card issuer when the Card Verification Value (CVV) is submitted during the authorization.
- AVS result: Address Verification Service (AVS) compares the cardholder's billing address with the issuer. It's mainly used for cards from the US, Canada, UK, and France.
- Fraud service result: Our tool evaluates transactions for risk and flags suspicious activities, with results displayed in the API response.
- System will automatically choose the default value if no selection is made.
- Choose authorization result to test if the card issuer approves or declines your transaction request. The result will be shown in the API response:
- Successful: Transaction is approved and authorized.
- Unsuccessful: Transaction is declined or rejected.
- System will automatically choose "Successful" as default value if no selection is made.
- Select authorization scenario for unsuccessful results. These are provided when the issuing bank declines an authorization request.
- This field will be available for selection when authorization result has been chosen as "Unsuccessful".
- System will automatically choose the default value if no selection is made.
- Specify refund scenario by selecting how the API should respond when processing refunds for this test card:
- This field will be available for selection when authorization result is "Successful".
- System will automatically choose "Successful" as default value if no selection is made.
- Generate test card. Click on "Generate" button to generate test card and other test data based on your selected testing scenario. To generate new test with new properties, you can reset your selection. Use this test card and other generated test data in your hosted checkouts or S2S API request towards Worldline and receive the response for the chosen scenario.
- Reset for new scenario. If you want to generate a new test scenario, click on the "Reset" button and choose new test card and data corresponding to a new test scenario.
Test scenarios
Currencies
To be able to test every single currency as listed in the currency table, please use following details.
| Card number | CVV | Amount | Currency code | Country code | Payment product ID | Auth code | AVS result | CVV result |
|---|---|---|---|---|---|---|---|---|
| 3000000000000004 | 432 | 3500 | USD | NL | 132 | OK2000 | 0 | 0 |
Fraud Services
Fraud services are by default enabled. The field CITY is controlling the outcome of the fraud check:
| City | Fraud Result | Payment status |
|---|---|---|
| Amsterdam | A(ccept) | 600/800 |
| Calais | C(hallenged) | 525 |
| Denver | D(eny) | 160 |
For the 525 status a formal decision is required to accept the payment or decline it. The API processchallenged is needed to accept the payment; the status will change to 800. When the payment needs to be declined the CancelPayment will set the status to 99999 (cancelled).
It is also possible to turn off the fraud services per transaction by adding skipFraudService: True to the request. There will be no fraud result in the response.
Delayed settlement
By default all transaction are set to Delayed settlement, except for the product that don’t support it. In Sale mode, payment will lead to status 800.
In Auth/Capture mode, a payment will lead to status 600, which subsequently requires to do a ApprovePayment to make the status go to 800.
Refunding
Transactions are not refundable on status Completed with status ID 800, as for that a separate process is scheduled to have the payment end up on a refundable status. Please wait for 1 hour for all your test transactions at status Completed with status ID 800 to be processed like this and set to be ready for refunds.
Next Additional information