Credit Card Payin Test Values
Card numbers that pay successfully in sandbox, and the billing address values that force a failed or unconfirmed payment.
Use these values to test how your integration handles successful, failed and unconfirmed card payments. They work only in the sandbox environment; in production they are treated like any other card details.
Before you start
- Create a sandbox checkout with Create Checkout and open it through the hosted link, the iframe or the Payin SDK. See Hosted Checkout Page and Iframe.
- Register the
checkout-status-changedwebhook if you want to test your webhook handler too.
Successful payments
These cards return a PAID checkout:
| Brand | Card number | Security code (CVC) |
|---|---|---|
| Visa | 4111 1111 1111 1111 | 555 |
| Mastercard | 5454 5454 5454 5454 | 555 |
- Expiration date: any date in the future.
- Cardholder name and billing address: any values, except the
address1values below.
Use these two cards. Other test card numbers do not give consistent results.
Failed and unconfirmed payments
Enter one of these values, in capital letters, as the first line of the billing address (address1) when you pay with a new card:
address1 | Checkout status | What it tests |
|---|---|---|
FAILED | FAILED, with errorTransaction set | A declined payment: your failure page, the checkout-failed event or PL_APP_CHECKOUT_FAILED message, and the webhook. |
UNKNOWN | UNKNOWN | A charge that was never confirmed. Your integration must not ask the buyer to pay again or cancel the order. Read the checkout status, not a transaction status, to tell it apart from a decline. |
Where to enter the value:
- Hosted page, iframe, or SDK with its own address fields: type it into the first address line of the billing address form.
- SDK with
billingDetails.fields.address: false: pass it insubmitPayment():
await element.submitPayment({
billingDetails: {
address: {
address1: "FAILED",
city: "Austin",
state: "TX",
postalCode: "78701",
country: "US",
},
},
});The values apply only when the buyer enters a new card. They have no effect on saved cards, bank transfers, Apple Pay or Google Pay. A card used with one of them is marked as unusable, so enter the card again for the next test.
Next steps
- Checkout Statuses and Failure Reasons
- Bank Transfer Payout Test Values for the payout side
Updated 18 days ago
