Card testing

Simulate successful payments

To simulate a successful card capture with advanced checkout integration in sandbox:

• Ensure the integration is in sandbox mode, with a sandbox client ID, and connected to api-m.sandbox.paypal.com endpoints.
• Use a test card number with a future expiration date and a 3-digit CVV, or a 4-digit CVV for American Express.

Test static card numbers

Test card numbers

Test advanced checkout payments and saved payment method use cases with these test card numbers:

Test generated card numbers

Credit card generator

Generate additional credit cards for regular sandbox testing and Standard payments. You can add generated credit cards to a PayPal sandbox account or use them to test credit card payments.

Simulate card error scenarios

Enter a rejection trigger in the First Name or Name on Card to simulate credit card error scenarios in advanced checkout integrations.

Rejection triggers

Rejection test simulations show a response-code that changes based on the test trigger you use. Rejection trigger values are case-sensitive.

Sample response

The response shows that the order is successfully created, but because a refusal was passed, the card payment status is DECLINED:

• Line 18 shows status=DECLINED. The card was refused.
• Line 51 shows avs_code=G. The card is globally unavailable.
• Line 52 shows cvv_code=P. The card wasn't processed.
• Line 53 shows response_code=5400. The card is expired.

1{
2  "id": "3M049991JF5624929",
3  "status": "COMPLETED",
4  "payment_source": {
5    "card": {
6      "last_digits": "6889",
7      "brand": "VISA",
8      "type": "CREDIT",
9    },
10  },
11  "purchase_units": [
12    {
13      "reference_id": "default",
14      "payments": {
15        "captures": [
16          {
17            "id": "2FB04508RA686960W",
18            "status": "DECLINED",
19            "amount": {
20              "currency_code": "USD",
21              "value": "500.00",
22            },
23            "final_capture": true,
24            "disbursement_mode": "INSTANT",
25            "seller_protection": { "status": "NOT_ELIGIBLE" },
26            "seller_receivable_breakdown": {
27              "gross_amount": { "currency_code": "USD", "value": "500.00" },
28              "paypal_fee": { "currency_code": "USD", "value": "13.44" },
29              "net_amount": { "currency_code": "USD", "value": "486.56" },
30            },
31            "links": [
32              {
33                "href": "https://api-m.sandbox.paypal.com/v2/payments/captures/2FB04508RA686960W",
34                "rel": "self",
35                "method": "GET",
36              },
37              {
38                "href": "https://api-m.sandbox.paypal.com/v2/payments/captures/2FB04508RA686960W/refund",
39                "rel": "refund",
40                "method": "POST",
41              },
42              {
43                "href": "https://api-m.sandbox.paypal.com/v2/checkout/orders/3M049991JF5624929",
44                "rel": "up",
45                "method": "GET",
46              },
47            ],
48            "create_time": "2022-08-09T22:20:05Z",
49            "update_time": "2022-08-09T22:20:05Z",
50            "processor_response": {
51              "avs_code": "G",
52              "cvv_code": "P",
53              "response_code": "5400",
54            },
55          },
56        ],
57      },
58    },
59  ],
60  "links": [
61    {
62      "href": "https://api-m.sandbox.paypal.com/v2/checkout/orders/3M049991JF5624929",
63      "rel": "self",
64      "method": "GET",
65    },
66  ],
67}

Processor response and error codes

To understand why a card payment was declined, review the Orders v2 processor response object in the Orders API response.

For more information about card payment decline reasons and possible values, see:

• Card decline errors.
• Error responses for CVV and AVS.
• Processor response codes for non-PayPal payment processors.

Simulate 3D Secure card payments

Use 3D Secure to authenticate cardholders through card issuers. When your customer submits their card details on your website for processing, you can trigger 3D Secure. When triggered, customers are prompted by their card-issuing bank to complete an additional verification step to enter a one-time or static password, depending on the issuer's method.

For more information about including 3D Secure authentication in your payment flow, see:

• Learn more about 3D Secure for advanced checkout using the Orders API.
• Simulate 3D Secure-supported scenarios and use test cards to verify your card integration.

Test integration

Test the recommended use cases for advanced checkout integration before you go live.

Accept payment

Decline payment

Authorize payment