WiPay
Payments APIv1.0.15

Testing

Test cards, sandbox environment, and testing best practices

WiPay considers testing to be the single most important aspect of any integration. Testing ensures your web-based application behaves consistently and predictably when using the Payments API.

Sandbox Environment

Set environment=sandbox in your API request to use the sandbox.

  • Sandbox account_number: 1234567890
  • Sandbox API Key for response-hash verification: 123

Important notes:

  • All reporting features are disabled for sandbox transactions
  • Payees and Payors do not receive automated emails
  • Transaction History information will not be available
  • The API behaves consistently for both live and sandbox transactions
  • The test cards on this page are valid only when environment=sandbox

Test Cards

  • Any expiry date in the current month and year or later will work
  • Use a three-digit CVV/CVC, or four digits for American Express
  • Any cardholder name will work
  • Any total will work unless the scenario itself says otherwise

Use the card set for the checkout flow described in each section. These sets are not interchangeable; a card valid for one sandbox checkout may be rejected by another.

Standard Card Payments — TTD

Use these cards to test Payments API hosted checkout when currency is TTD.

CodeBrandCard Number3DSScenario
C01YZVisa40000000000027192.x.yAttempts processing frictionless, Status=A
C02YZVisa40000000000025032.x.yStep-up challenge, Status=Y
C03YZMastercard52000000000021512.x.yStep-up challenge, Status=Y
C04YZVisa40000000000026442.x.yStep-up challenge, Status=U, Authentication error
C05YZVisa40000000000023542.x.yEnrollment timeout, Enrolled=U, Directory Server Error=402
C06YZVisa40000000000025602.x.yAuthentication bypassed, Enrolled=B
C07YZVisa40000000000023132.x.yFrictionless, Status=U
C08YZMastercard52000000000022682.x.yFrictionless, Status=U
C09YZVisa40000000000024202.x.yStep-up challenge, Status=U
C10YZVisa40000000000024462.x.yEnrollment check error, Enrolled=U, Directory Server Error=101
C11YZMastercard52000000000020372.x.yEnrollment check error, Enrolled=U, Directory Server Error=101
C12YZVisa40000000000029902.x.yAuthentication unavailable on lookup, Enrolled=U, Directory Server Error=101
C13YZMastercard52000000000024092.x.yAuthentication unavailable on lookup, Enrolled=U, Directory Server Error=101
C14YZVisa40000000000023702.x.yStep-up challenge, Status=N
C15YZMastercard52000000000022352.x.yFrictionless, Status=Y

Standard Card Payments — USD and other currencies

Use these cards to test Payments API hosted checkout when currency is USD or any other supported currency.

Use any future expiry date and any three-digit CVC/CVV, except American Express cards, which require four digits. Brand acceptance depends on the merchant account and processing platform.

None means no 3DS interaction is normally required for that test scenario, not that the card brand cannot support 3DS. Use the dedicated 3DS scenarios to test authentication and challenge handling.

CodeBrandCard Number3DSScenario
S01TPVisa4242424242424242NoneStandard payment success; no 3DS challenge normally required
S02TPVisa4000000000000002NoneStandard payment decline — card_declined / generic_decline
S03TPVisa4000000000000127NoneDecline — incorrect CVC
S04TPVisa40000000000032202.x.y3DS required; authentication/challenge completed successfully; payment succeeds
S05TPVisa40000000322000002.x.y3DS frictionless; authentication succeeds without customer challenge
S06TPVisa40000082600031782.x.y3DS required; authentication succeeds, then payment declined — insufficient_funds
S07TPVisa40000084000012802.x.y3DS required; 3DS lookup/authentication processing error; payment declined
S08TPMastercard5555555555554444NoneStandard payment success
S09TPAmerican Express378282246310005NoneStandard payment success — 15-digit card number, four-digit CVC/CVV; 3DS not supported for this test card
S10TPDiscover6011111111111117NoneStandard payment success

For the required-3DS challenge case, also exercise unsuccessful authentication and cancellation using the sandbox authentication screen.

Trusted Card — TTD

Use these cards to test Create Trusted Card, Verify Trusted Card, and Charge Trusted Card in sandbox when currency is TTD.

CodeBrandCard Number3DSScenario
P01TZMastercard51002700000000982.x.yFrictionless, Status=N, Payment Completion not permitted (response code 12)
P02TZVisa40120000000201212.x.yFrictionless, Status=N, Payment Completion not permitted (response code 12)
P03TZMastercard51002700000000232.x.yFrictionless, Status=Y
P04TZVisa40120000000200712.x.yFrictionless, Status=Y
P05TZMastercard51002700000000562.x.yChallenge, Status=N, Payment Completion not permitted (response code 12)
P06TZVisa40120000000200892.x.yFrictionless, Status=A
P07TZVisa46666666666622222.x.yFrictionless, Status=A, ISO Response Code=05, CVV Response=N
P08TZMastercard51002700000000722.x.yFrictionless, Status=R
P09TZMastercard55556666666622222.x.yFrictionless, Status=U, ISO Response Code=05
P10TZVisa41111111111199992.x.yFrictionless, Status=A, ISO Response Code=98
P11TZMastercard51002700000000312.x.y3DS2 Challenge, Status=Y
P12TZVisa40120000000200062.x.y3DS2 Challenge, Status=Y
P13TZMastercard51111111111133332.x.yFrictionless, Status=A, ISO Response Code=05
P14TZVisa40120100000200702.x.yFrictionless, Fingerprinting, Status=Y
P15TZMastercard51002710000001202.x.yFrictionless, Fingerprinting, Status=Y
P16TZVisa41111111111100002.x.y3DS2 Challenge, Status=Y, ISO Response Code=91
P17TZMastercard51111111111100002.x.y3DS2 Challenge, Status=Y, ISO Response Code=91
P18TZVisa40120100000200882.x.yFrictionless, Fingerprinting, Status=A
P19TZVisa40120100000200052.x.y3DS2 Challenge, Fingerprinting, Status=Y
P20TZVisa40120000000200712.x.y3DS2 Challenge, include ChallengeIndicator=03