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

Successful payments

These cards return a PAID checkout:

BrandCard numberSecurity code (CVC)
Visa4111 1111 1111 1111555
Mastercard5454 5454 5454 5454555
  • Expiration date: any date in the future.
  • Cardholder name and billing address: any values, except the address1 values 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:

address1Checkout statusWhat it tests
FAILEDFAILED, with errorTransaction setA declined payment: your failure page, the checkout-failed event or PL_APP_CHECKOUT_FAILED message, and the webhook.
UNKNOWNUNKNOWNA 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 in submitPayment():
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


Did this page help you?