Environments
Sandbox
API URL: https://sandbox-api.paysimple.com
The PaySimple Sandbox is a test environment that is designed to simulate our active production environment. It is a safe environment in which to test API connectivity and functionality.
Payments processed in the Sandbox environment are routed to test authorization and capture servers which are designed to behave in the same manner as our production servers. However, none of the transactions will be submitted for processing, and no funds will be transferred.
Obtaining Sandbox Credentials
Since the Sandbox mimics an active production environment, the same authentication requirements apply and you will need to obtain a PaySimple sandbox account in order to use it. To do this, contact our API Support Team at [email protected] with the following information:
- The email address you would like associated with your account.
- A request to generate a Sandbox API Key
A PaySimple API Support team member will contact you with the sandbox API Username and the sandbox API Key (a Shared Secret for Server‐to Server authentication).
Test Cards
It is against PCI rules to use live account numbers in test environments. Please be certain that you only use test account numbers in the PaySimple sandbox environment.
The following Credit Cards can be used for test transaction processing in the Sandbox environment.
Note: The expiration dates on the test cards below can be any date. "12/2023" below are just example values.
Test Credit Cards
| Credit Card Type | Card Number | Expiration Date | CVV2 Code |
|---|---|---|---|
| Visa | 4111111111111111 | Any future date | 996 |
| MasterCard | 5454545454545454 | Any future date | 996 |
| American Express | 371449635398456 | Any future date | 996 |
| Discover | 6011000995504101 | Any future date | 996 |
WorldPay Express NULL Processor Error Amounts
The NULL Processor is a host simulator that provides a means for integrators to develop and test their applications by passing in certain parameters to receive expected results.
Please note the error amounts are different if you are set up on the TriPOS Test processor.
| Dollar Amount | Result | Code | Description | |
|---|---|---|---|---|
| $1.00 | sucesss | 1000 | Approved | |
| $23.05 | success | 4518 | Partial approval | |
| $0.20 | declined | 4007 | Do Not Honor | |
| $0.21 | declined | 4054 | Invalid Expiration Date | |
| $0.22 | success | 1000 | Duplicate approved | |
| $0.23 | failed | 4506 | Duplicate transaction | |
| $0.24 | declined | 4004 | Pick up card | |
| $0.25 | declined | 4001 | Referral / Call Issuer | |
| $1.01 | failed | 4019 | Invalid data |
ACH Test Accounts
The following Bank Accounts can be used for test transaction processing in the Sandbox environment. (Non-Stripe)
| Routing Number | Account Number | Bank Name |
|---|---|---|
| 131111114 | 751111111 | PaySimple Bank |
| 307075259 | 751111111 | PaySimple Bank |
| 325272034 | 751111111 | PaySimple Bank |
| 011401533 | 043838103 | PaySimple Bank |
| 011401533 | 684329783 | PaySimple Bank |
| 011401533 | 588730614 | PaySimple Bank |
Forte ACH Sandbox Trigger Values
The Forte Sandbox is a host simulator that provides a means for integrations to develop and test their applications by passing in certain parameters to receive expected results.
The table below shows some of the common ACH authorization results. Authorization is immediate, however the settlement of an ACH transaction can occur several days after an authorization.
| Trigger Value | Transaction Result | Code: Description |
|---|---|---|
| $1.00 Amount | Success (Approved) | 1000 |
| 021000021 Routing Number 987654321 Account Number | Decline | 4507 |
| $19.83 or $1983 or $1.33 Amount | Decline | 4005 |
| "XYZ" SEC Code | Failure | 4005 |
The table below shows some of the common ACH settlement results. Settlements occur several days after an authorization.
| Dollar Amount | Settlement Result | R-Code: Description |
|---|---|---|
| $1.00 | Settled | |
| $1.01 | Returned | R01: Insufficent Funds |
| $1.02 | Returned | R02: Account Closed |
| $1.03 | Returned | R03: No Account |
| $1.07 | Returned | R07: Authorization Revoked |
| $1.16 | Returned | R16: Account Frozen |
| $1.23 | Returned | R23: Payment Refused |
| $1.57 | Returned | R57: Stale Date |
| $1.95 | Returned | R95: Over Limit |
Forte ACH Processing in Sandbox
Once your sandbox account is enabled and test transactions are being run, please email [email protected] to request that the transaction status is updated.
Production
API URL: https://api.paysimple.com
Once you have completed your work in our Sandbox environment, you can receive credentials for a Client Account and associated production API Key by contacting our API Support Team at [email protected]
You can easily convert your Sandbox Code for the Production environment by changing the base url, API Username, and API Key to the Production values.
Updated 9 months ago