A PayPal sandbox test card is a fake credit card number that PayPal accepts only inside its sandbox, the isolated copy of the PayPal platform built for developers. The number carries no real value, cannot be charged, and is always rejected by live PayPal. Developers use it to simulate approvals, declines, and card verification without ever handling a real cardholder account.
How to Use a PayPal Developer Test Card
What is a PayPal sandbox test card used for?
Test cards let you walk the full checkout flow, from payment authorization to refund and chargeback simulation, against a fake funding source. They also let you trigger specific error codes so your front end can display the right message. Once your integration passes in the sandbox, you swap in your live API credentials and the same code path runs against real cards.
PayPal Sandbox Credit Card Numbers Guide
Where do you find PayPal sandbox test card numbers?
PayPal publishes a card number list and a credit card generator inside the Developer Dashboard, under Sandbox and then Accounts. The generator produces a card with a matching CVV, expiry date, and billing zip for the sandbox buyer profile you select. PayPal rotates these numbers, so confirm the current list in the dashboard before hard-coding anything into your test suite. Generic gateway test numbers such as 4111111111111111 for Visa and 5555555555554444 for Mastercard also pass in most sandbox flows.
Which test card numbers work in the PayPal sandbox?
- Visa: 4111111111111111
- Mastercard: 5555555555554444
- American Express: 378282246310005
- Discover: 6011111111111117
These numbers pass the Luhn check and behave like valid cards in the test environment. PayPal's own dashboard list may differ, and either set is fine as long as the number is Luhn-valid and tied to a sandbox buyer account.
how to test paypal sandbox card
What expiry date, CVV, and billing address should you use?
Use any future expiry date in MM/YYYY format, because an expired date forces a decline. Visa, Mastercard, and Discover take a 3-digit CVV, while American Express takes a 4-digit CID. Match the billing address to the country of the sandbox account, since a US sandbox buyer with a UK address will fail address verification.
How do you add a test card to a sandbox buyer account?
- Log in to the Developer Dashboard and open Sandbox, then Accounts.
- Select a Personal or Business sandbox account and click View Details.
- Open the funding tab and add a card with the generated number, expiry, and CVV.
- Confirm the card, then run a test transaction from your staging site.
Why does a sandbox test card get declined?
Most declines come from a mismatch between the card brand and the CVV length, an expired date, or a card that was never added to the sandbox buyer profile. Using live API credentials against a test card number is another common cause. Review the raw API response for the decline code, then correct the field it names.
Do sandbox test cards work on live PayPal?
No. Live PayPal routes every authorization to the real card networks, where test numbers do not exist as accounts. Attempting a test card against a live merchant account produces a decline and can flag the account for review. Keep test credentials and test cards in the sandbox only.
Is using a PayPal sandbox test card legal?
Yes, using published test cards in a sandbox is standard developer practice and is fully legal. The line is crossed when real card numbers are used in a test system or when card data is used without the owner's consent. Treat test cards as what they are: placeholders that never touch a real account.