Testing Scenarios

Learn how to use a test order to ensure that your integration is functioning properly.

For various payment methods, you'll find test card numbers and information on how to test for success and error scenarios. 
Digital River maintains two primary test environments for clients: Production Test Environment (PTE) and Client Test Environment (CTE). The PTE is used for the Digital River API while the CTE is intended for the Commerce API. In both environments, you'll never interact directly with the payments services. Instead, you'll be directed to a generic page that contains accept and reject options.
Payment methods
Credit Cards
PayPal
PayPal Credit
Wire Transfer
Direct Debit
Direct Debit GB
Alipay
Credit Cards
Success Scenarios 
If the card numbers in this section fail to produce a success scenario, try entering a different purchase amount, currency, or quantity. 
The Get Credit Card Numbers website is a useful resource for generating valid test card numbers. The site provides numbers that are a possible combination of characters which validate when passed through the MOD 10 algorithm. 
Basic Card Numbers 
To test a successful payment, use the following credit card numbers. The expiration date must be at least one day in the future. With the exception of Visa, the security code can be any random three or four digit number.
Card Number
Brand
Expiration Date
Security Code
3434 567890 12341
American Express
Any future date
Any four digits
3034 567890 1235
Diners Club
Any future date
Any three digits
6011 9876 9876 9876
Discover
Any future date
Any three digits
3528 9876 9876 9879 
JCB 
Any future date
Any three digits
5466 1600 0000 0008
Mastercard
Any future date
Any three digits
6226 2200 0000 0009
UnionPay
Any future date
Any three digits
4444 2222 3333 1111
Visa
Any future date
123
3D Secure 1 Card Numbers
You can also test how your integration handles different 3D Secure 1 authentication scenarios. To test your 3D Secure 1 integrations, use the the following test data:
Card Number
Brand
Expiration Date
Security Code
Notes
4212 3456 7890 1237
Visa
10/2030
737
When prompted to authenticate via the test page, enter user and password.
3D Secure 2 Card Numbers
You can also test how your integration handles different 3D Secure 2 authentication scenarios. To test your 3D Secure 2 integrations, use the the following test data:
Card Number
Brand
Expiration Date
Security Code
3714 4963 5398 431
American Express
10/2030
7373
4035 5014 2814 6300
Cartes Bancaires
03/2030
737
3056 9309 0259 04
Diners
03/2030
737
6011 1111 1111 1117
Discover
03/2030
737
3566 1111 1111 1113
JCB
03/2030
737
5454 5454 5454 5454
Mastercard
03/2030
737
6212 3456 7890 1232
UnionPay
03/2030
737
4917 6100 0000 0000
Visa
03/2030
737
When prompted for 3D Secure 2 text challenges, use these credentials:
App Type
Password
Mobile
1234
Web
password
Error Scenarios
Use these test card numbers to create payments that generate specific error scenarios. The expiration date must be at least one day in the future. The security code can be any random three digit number:
Card Number
Error Scenario
4000 0000 0000 3295
Source creation fails. The Source state is failed.
4000 0000 0000 3600
Source creation is successful but Charge creation fails. The Charge state is failed.
4000 0000 0000 4103
Source and Charge creation are successful, but Capture fails. The Capture state is failed.
4000 0000 0000 4663
Source, Charge and Capture are successful, but Refund fails. The Refund state is failed.
4000 0000 0000 4442
Source and Charge creation are successful, but Cancel fails. The Cancel state is failed.
PayPal
Success Scenarios 
After providing success scenario test data, you'll receive a Source in a pending_redirect state. Follow the redirect to select one of the options on the authorization page: 
Option
Description
Approve
Source moves to chargeable state
Decline
Source remains in a pending_redirect state.
Error Scenarios 
After being triggered, PayPal error scenarios provide the following unique data to the Source owner: 
Scenario
Description
SourceCreationFail
Source creation fails. The Source state is failed .
ChargeCreationFail
Source creation is successful but Charge creation fails. The Charge state is failed .
RefundFail
Source and Charge creation are successful. Any refunds against the charge fail. Refund state is failed .
PayPal Credit
Success Scenarios 
After providing success scenario test data, you'll receive a Source in a pending_redirect state. Follow the redirect to select the following options on the authorization page:
Option
Description
Approve
Source moves to chargeable state
Decline
Source remains in a pending_redirect state.
Error Scenarios 
After being triggered, PayPal credit error scenarios provide the following unique data to the Source owner: 
Scenario
Description
SourceCreationFail
Source creation fails. The Source state is failed .
ChargeCreationFail
Source creation is successful but Charge creation fails. The Charge state is failed .
RefundFail
Source and Charge creation are successful. Any refunds against the charge fail. Refund state is failed .
Wire Transfer
Success Scenarios 
After providing success scenario test data, you'll receive a Source in a pending_funds state. The Source may then be used to complete your Checkout or Order .
Error Scenarios 
After being triggered, Wire Transfer error scenarios provide the following unique data to the Source owner:
Scenario
Description
SourceCreationFail
Source creation fails. The Source state is failed .
SourceFailWithDelay
Source creation is successful but Charge creation fails. The Charge state is failed .
RefundFailWhileCreation
Source and Charge creation are successful. Any refunds against the charge fail. The Refund state is failed .
RefundFailAfterPaymentInfo
Source and Charge creation are successful. A refund request against the charge is successful but ultimately fails to refund.
Direct Debit
Success Scenarios 
After providing success scenario test data, you'll receive a Source in a pending_redirect state. Follow the redirect to select the following options on the authorization page:
Option
Description
Approve
Source moves to chargeable state
Decline
Source remains in a pending_redirect state.
Error Scenarios 
After being triggered, Direct Debit error scenarios provide the following unique data to the Source owner:
Scenario
Description
SourceFail
Source creation fails. The Source state is failed .
SourceFailAfterRedirect
Source moves to failed state after redirecting from payment page.
ChargeFail
Source creation is successful but Charge creation fails. The Charge state is failed .
ChargeFailedAfterPending
The Charge is initially created in a pending state. After a webhook call, the Charge is moved to a failed state.
RefundFail
Source and Charge creation are successful. Any refunds against the charge fail and the Refund state is failed .
RefundFailedAfterPending
The Refund is initially created in a pending state. After a webhook call, the Refund is moved to a failed state.
ChargeRemainPending
The Charge remains in a pending state after creation.
Direct Debit GB
Success Scenarios 
After providing success scenario test data, you'll receive a source in a pending_redirect state. Follow the redirect to select the following options on the authorization page:
Option
Description
Approve
Source moves to chargeable state
Decline
Source remains in a pending_redirect state.
Error Scenarios 
After being triggered, Direct Debit GB error scenarios provide the following unique data to the Source owner:
Scenario
Description
[email protected]
Source creation fails. The Source state is failed .
[email protected]
Source moves to a failed state after redirecting from the payment page.
[email protected]
The Charge is initially created in a pending state. After a webhook call, the Charge is moved to a failed state.
[email protected]
Source and Charge creation are successful. Any refunds against the charge fail and the Refund state is failed
[email protected]
The Refund is initially created in a pending state. After a webhook call, the Refund is moved to a failed state.
Alipay
Success Scenarios 
After providing success scenario test data, you'll receive a Source in a pending_redirect state. Follow the redirect to select one of the options on the authorization page: 
Option
Description
Approve
Source moves to chargeable state
Decline
Source remains in a pending_redirect state.
Error Scenarios 
After being triggered, Alipay error scenarios provide the following unique data to the Source owner:
Scenario
Description
authFail
Source creation fails. The Source state is failed .
authFailAfterRedirect
Source creation is successful but Charge creation fails. The Charge state is failed .
refundFail
Source and Charge creation are successful. Any refunds against the charge fail. The Refund state is failed .

Payment sessions

Next - Resources

Release notes

Last updated 6 months ago

Card Number	Brand	Expiration Date	Security Code
3434 567890 12341	American Express	Any future date	Any four digits
3034 567890 1235	Diners Club	Any future date	Any three digits
6011 9876 9876 9876	Discover	Any future date	Any three digits
3528 9876 9876 9879	JCB	Any future date	Any three digits
5466 1600 0000 0008	Mastercard	Any future date	Any three digits
6226 2200 0000 0009	UnionPay	Any future date	Any three digits
4444 2222 3333 1111	Visa	Any future date	123

Card Number	Error Scenario
4000 0000 0000 3295	`Source` creation fails. The `Source` state is `failed`.
4000 0000 0000 3600	`Source` creation is successful but `Charge` creation fails. The `Charge` state is `failed`.
4000 0000 0000 4103	`Source` and `Charge` creation are successful, but `Capture` fails. The `Capture` state is `failed`.
4000 0000 0000 4663	`Source`, `Charge` and `Capture` are successful, but `Refund` fails. The `Refund` state is `failed`.
4000 0000 0000 4442	`Source` and `Charge` creation are successful, but `Cancel` fails. The `Cancel` state is `failed`.

Option	Description
Approve	`Source` moves to `chargeable` state
Decline	`Source` remains in a `pending_redirect` state.

Scenario	Description
SourceCreationFail	`Source` creation fails. The `Source` state is `failed` .
ChargeCreationFail	`Source` creation is successful but `Charge` creation fails. The `Charge` state is `failed` .
RefundFail	`Source` and `Charge` creation are successful. Any refunds against the charge fail. `Refund` state is `failed` .

Scenario	Description
SourceFail	`Source` creation fails. The `Source` state is `failed` .
SourceFailAfterRedirect	`Source` moves to `failed` state after redirecting from payment page.
ChargeFail	`Source` creation is successful but `Charge` creation fails. The `Charge` state is `failed` .
ChargeFailedAfterPending	The `Charge` is initially created in a `pending` state. After a webhook call, the `Charge` is moved to a `failed` state.
RefundFail	`Source` and `Charge` creation are successful. Any refunds against the charge fail and the `Refund` state is `failed` .
RefundFailedAfterPending	The `Refund` is initially created in a `pending` state. After a webhook call, the `Refund` is moved to a `failed` state.
ChargeRemainPending	The `Charge` remains in a `pending` state after creation.

Scenario	Description
[email protected]	`Source` creation fails. The `Source` state is `failed` .
[email protected]	Source moves to a `failed` state after redirecting from the payment page.
[email protected]	The `Charge` is initially created in a `pending` state. After a webhook call, the `Charge` is moved to a `failed` state.
[email protected]	`Source` and `Charge` creation are successful. Any refunds against the charge fail and the `Refund` state is `failed`
[email protected]	The `Refund` is initially created in a `pending` state. After a webhook call, the `Refund` is moved to a `failed` state.

Scenario	Description
authFail	`Source` creation fails. The `Source` state is `failed` .
authFailAfterRedirect	`Source` creation is successful but `Charge` creation fails. The `Charge` state is `failed` .
refundFail	`Source` and `Charge` creation are successful. Any refunds against the charge fail. The `Refund` state is `failed` .