Environments

Sandbox

API URL: ht​tps://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 TypeCard NumberExpiration DateCVV2 Code
Visa411111111111111112/2023996
MasterCard545454545454545412/2023996
American Express37144963539845612/2023996
Discover601100099550410112/2023996

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 AmountResultCodeDescription
$1.00sucesss1000Approved
$23.05success4518Partial approval
$0.20declined4007Do Not Honor
$0.21declined4054Invalid Expiration Date
$0.22success1000Duplicate approved
$0.23failed4506Duplicate transaction
$0.24declined4004Pick up card
$0.25declined4001Referral / Call Issuer
$1.01failed4019Invalid data

ACH Test Accounts

The following Bank Accounts can be used for test transaction processing in the Sandbox environment.

Routing NumberAccount NumberBank Name
131111114751111111PaySimple Bank
307075259751111111PaySimple Bank
325272034751111111PaySimple Bank
011401533043838103PaySimple Bank
011401533684329783PaySimple Bank
011401533588730614PaySimple 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 ValueTransaction ResultCode: Description
$1.00 AmountSuccess (Approved)1000
021000021 Routing Number
987654321 Account Number
Decline4507
$19.83 or $1983 or $1.33 AmountDecline4005
"XYZ" SEC CodeFailure4005

The table below shows some of the common ACH settlement results. Settlements occur several days after an authorization.

Dollar AmountSettlement ResultR-Code: Description
$1.00Settled
$1.01ReturnedR01: Insufficent Funds
$1.02ReturnedR02: Account Closed
$1.03ReturnedR03: No Account
$1.07ReturnedR07: Authorization Revoked
$1.16ReturnedR16: Account Frozen
$1.23ReturnedR23: Payment Refused
$1.57ReturnedR57: Stale Date
$1.95ReturnedR95: 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: ht​tps://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.