Skip to main content

Sandbox Test Cards

The Sandbox Gateway is a fictitious card processor for sandbox tenants. It needs no API keys and never moves money, so you can test every card outcome your integration has to handle.

Add "Sandbox Gateway" to your connectors on a sandbox tenant. A sandbox tenant with no card connector uses it automatically.

Every card number is approved, except the test cards on this page. Use any future expiry date, any 3-digit CVC and any cardholder name.

Declined payments​

These cards are declined. The payment intent stays open, so the customer can try another card, and the transaction's failure reason carries the code below.

Card numberScenarioFailure reason
4000000000000002Generic declinerejected_by_bank
4000000000009995Insufficient fundsinsufficient_funds
4000000000009987Lost cardcard_reported_lost_or_stolen
4000000000009979Stolen cardcard_reported_lost_or_stolen
4000000000000069Expired cardcard_expired
4000000000000127Incorrect CVCwrong_card_credentials
4000000000000119Processing errorissuer_unavailable
4242424242424241Incorrect numberwrong_card_credentials
4000000000006975Velocity limit exceededcard_limit_exceeded
4000000000000341Declined when charged after being savedrejected_by_bank
4100000000000019Always blocked as fraudsuspected_fraud
4000000000004954Highest risk, blocked as fraudsuspected_fraud
4000000000000101CVC check failswrong_card_credentials
40000084000012803D Secure lookup error, then declinedrejected_by_bank

4242424242424241 fails the card number check, so the Orchestrapay payment form refuses it before it reaches the gateway. Send it through the API to see the decline.

3D Secure​

These cards ask for 3D Secure authentication. The payment form opens the authentication step in a modal, the same way it does for a real bank, and the Sandbox Gateway shows a test page there with two buttons:

  • Complete authentication finishes the payment with the result in the table.
  • Fail authentication declines it with the failure reason authentication_required.

The four 3D Secure 2 cards each show their own kind of challenge, so you can see how it looks inside your checkout. Every challenge also has a Fail authentication button.

Card numberScenarioAfter you complete authentication
40000000000032203D Secure requiredApproved
40000084000000273D Secure required, US cardApproved
40000027600031843D Secure on every paymentApproved
40000025000031553D Secure unless the card is set up for future paymentsApproved
4000003800000446Card already set up, 3D Secure on every payment the customer makesApproved
40005826000000943D Secure 2, out-of-band: approve the payment in a banking app, then confirmApproved
40005826000000453D Secure 2, one-time passcode: enter any 6 digitsApproved
40005826000001023D Secure 2, single select: pick where to send the codeApproved
40005826000001103D Secure 2, multi select: tick the purchases you recogniseApproved
40000084000016293D Secure required, then declinedDeclined, rejected_by_bank
40000082600031783D Secure required, then insufficient fundsDeclined, insufficient_funds

These cards support 3D Secure but do not need it, so they are approved without the test page:

Card numberScenario
4242424242424242Not enrolled in 3D Secure
40000000000030553D Secure supported, not required
40000000000030973D Secure supported, its lookup errors, not required
4000000032200000Frictionless authentication
4000008405600003Authenticated only when your risk rules ask for it
3782822463100053D Secure not supported

Forcing 3D Secure​

When an orchestrator node's processing options force 3D Secure on the Sandbox Gateway, every card that would be approved shows the test page first. Declining cards are still declined straight away.

Disputes​

These cards are approved, and a few seconds later the Sandbox Gateway opens a dispute on the payment. Your webhook endpoints receive dispute.created (see Dispute Webhook), and the dispute appears on the Disputes page with 7 days to respond.

Card numberScenarioDispute
4000000000000259Fraudulent disputeChargeback, fraudulent
4061219946393810Fraudulent dispute, opened shortly after the paymentChargeback, fraudulent
6026507838377928Fraudulent dispute on a Discover cardChargeback, fraudulent
4000000000002685Product not receivedChargeback, product_not_received
4000000000001976InquiryInquiry, general
4000000404000079Two disputes on one paymentTwo chargebacks, fraudulent and product_not_received
4000000404000038Fraudulent dispute, Visa Compelling Evidence 3.0 eligibleChargeback, fraudulent
4000008400000779Visa compliance disputeChargeback, noncompliant
5105008400000002Mastercard compliance disputeChargeback, noncompliant
4000000001000043Fraudulent dispute, eligible for automatic responsesChargeback, fraudulent
4000000404004816Visa Rapid Dispute Resolution cardChargeback, fraudulent
4000000404005649Verifi dispute deflection cardChargeback, fraudulent
5105000300000018Ethoca alert cardChargeback, fraudulent
4000008400000795A partial refund opens a dispute for the restChargeback, fraudulent, see Refunds

A sandbox tenant is not enrolled in dispute prevention, so the Rapid Dispute Resolution, Verifi and Ethoca cards always open a dispute.

Settling a test dispute​

Respond to the dispute from the Disputes page. The Sandbox Gateway decides the outcome from the explanation you write:

Write in the explanationA chargeback becomesAn inquiry becomes
winning_evidenceWonClosed
losing_evidenceLostClosed
escalate_inquiry_evidenceUnder reviewA chargeback that needs a response
Anything elseUnder reviewClosed

Sandbox disputes take evidence as submitted and cannot hold a draft. Each change sends dispute.updated, or dispute.closed once the dispute is won, lost or closed.

Refunds​

These cards are approved. Their refunds behave as follows:

Card numberScenario
4000000000005126The refund fails
4000000000007726The refund stays pending, then succeeds within about 5 minutes, when Orchestrapay next checks it
4000008400000795The first partial refund succeeds and opens a fraudulent dispute for the amount left. Later refunds leave that dispute as it is, and a full refund opens no dispute.

See Refunds for how refunds and their statuses work.

Cards that are approved​

Every other card number is approved, including the cards that simulate a check your sandbox does not run:

Card numberScenario
4000000000009235Elevated fraud risk
4000008400000407High fraud dispute score
4000008400000159High early fraud warning score
4000008400001017Dynamic risk thresholds
4001858821843804Free trial abuse
4000058400307872CVC check fails with elevated risk
4000058400306072Postal code check fails with elevated risk
4000000000000036Postal code check fails
4000000000000028Address line check fails
4000000000000010Postal code and address line checks fail
4000000000000044Address checks unavailable
4000000000005423Early fraud warning
4000000000001208Captcha challenge
4000000000003725Captcha challenge
4000000000000077Funds go straight to your available balance
4000003720000278Funds go straight to your available balance, international card