Skip to content
Last updated

Sandbox Testing

This guide covers sandbox account setup for testing PayPal and Apple Pay through the SDK, provides information about Venmo testing, and covers simulating ACH return codes in non-production environments.


PayPal

PayPal provides a sandbox environment for testing. Venmo, however, cannot be fully tested in that sandbox as of 2026, so NPS does not support Venmo testing.

Developer Account Setup (Integration Partner)

Integration partner team members create PayPal Developer accounts as needed. Each account holder then creates sandbox buyer accounts for their own testers.

  1. Go to developer.paypal.com and click Sign Up to create a PayPal Personal account.
  2. Log in to developer.paypal.com with the newly created account credentials.

Per-Tester Setup: Sandbox Buyer Account

Create one sandbox buyer account for each tester. Repeat these steps per person. Do not share a single login across testers.

  1. Log in to developer.paypal.com.
  2. Navigate to Testing Tools → Sandbox Accounts in the left navigation bar.
  3. Click Create Account to create a sandbox test account.
  4. Under Do you want a more customized account?, click Create to access additional configuration options.
  5. Set Account Type to Personal (buyer account).
  6. Provide an email address and password. Record these — they are the tester's login credentials.
  7. Set Verified Bank Account to Yes.
  8. Set Payment Card to PayPal.
  9. Click Create Account.
  10. Confirm the new account appears on the Sandbox Accounts page.
  11. Share the email address and password from step 6 with the tester.
  12. The tester enters this login when prompted to sign in at sandbox.paypal.com during the PayPal checkout flow in the SDK.

PayPal Negative Testing

The sandbox environment supports negative testing scenarios to validate error handling for PayPal AUTH_ONLY transactions.

Use the following test amounts to simulate gateway-level errors:

AmountTransaction TypeExpected Result
9999.01AUTH_ONLYReturns E500 error
9999.02AUTH_ONLYReturns E412 error

Notes

  • The sandbox account does not need to be linked to NPS in any way.
  • Sandbox credentials are separate from live PayPal credentials.

Apple Pay

Apple Pay sandbox accounts must be created by NPS. You cannot create one independently.

Steps

  1. Contact NPS Tech Support and request an Apple Pay sandbox account.
  2. Tech Support will coordinate with the NPS team to create the account.
  3. Provide an email address that does not already have an Apple ID associated with it — this is required by Apple for sandbox account creation.
  4. Once created, you will receive sandbox credentials to use during Apple Pay testing in the SDK.

Notes

  • The email address provided must not be associated with an existing Apple ID.
  • Apple Pay sandbox testing requires Safari or an Apple Pay-capable device/browser.

ACH Return Code Testing

In non-production environments, you can simulate ACH return codes for a charge without waiting for a return file from the bank. Creating an ACH_CHARGE for one of the amounts below triggers the corresponding ACH return and reason code when the ach-webhook job runs.

Use the following test amounts to simulate a returned transaction:

AmountR CodeDescription
$0.01R01Insufficient funds
$0.02R02Receiver's account is closed
$0.03R03No account on file / RDFI unable to locate account
$0.04R04Invalid account number
$0.06R06Returned at ODFI request
$0.07R07Authorization revoked by receiver
$0.08R08Payment stopped
$0.09R09Uncollected funds
$0.10R10Originator not known or not authorized to debit
$0.11R11Entry not in accordance with terms of authorization
$0.13R13Invalid routing number
$0.15R15Account holder deceased
$0.16R16Account funds frozen
$0.17R17Invalid data, see addenda
$0.20R20Account does not allow ACH, or limit exceeded
$0.23R23Credit entry refused by receiver
$0.24R24Duplicate entry
$0.29R29Corporate customer advises not authorized