Testing Trace ACH Inside Sandbox
Trace ACH, it's one of the most common and secure ways to move money between bank accounts. PayTrace helps you accept these payments online, which is far more efficient than accepting paper checks or wire transfers.
To begin testing Trace ACH, it must first be enabled on your sandbox account. If you do not currently have the ability to test Trace ACH, please reach out to developersupport@paytrace.com and request for it to be added to your sandbox for testing purposes.
Testing Information for processing with Trace ACH
Here's the essential information and methods for processing with Trace ACH in the sandbox:
Account Numbers
| Routing Numbers
|
---|---|
You can use any 7 or 8-digit number. | 130000006, 140000009, 150000002, 160000005, 170000008, 180000001, 190000004 |
Testing Different Types of Returns
The sandbox environment allows you to simulate various ACH return scenarios by using specific formats within the Description field of your transaction.
To trigger a specific return, use the following format: DayNRxx
N: The number of days after creation to trigger the return (enter a number from 1 to 9).
xx: The two-character ACH return reason code.
Common Return Codes for Testing:
R01: Insufficient Funds (NSF)
R02: Closed Account
R03: Account Not Found
R10: Unauthorized
R29: Corporate Customer Advises Not Authorized
Example: Entering "Day2R03" in the Description field will create a transaction that will be returned after 2 days with the reason code R03 (Account Not Found).
Important Timing:
Sandbox transactions are originated on the same day they are created at 6:00 PM ET.
Sandbox transactions typically settle after 3 business days.
Bank holidays are non-processing days. We observe: New Year's Day, MLK Day, Presidents' Day, Memorial Day, Juneteenth National Independence Day, Independence Day, Labor Day, Columbus Day, Veterans Day, Thanksgiving Day, and Christmas Day.
Test Cases
Test case 1: One-Off Payment for CCD
Day 0: Creation
Create a CCD Payment for $0.01 without using a Customer Token.
Verify that the new transaction status is Accepted.
Day 1: Origination
Verify Originated status.
LIVE TESTING: Log in to your online banking and confirm a $0.01 debit.
Day 2: Wait
No action required.
Day 3: Wait
No action required.
Day 4: Settlement
Verify Settled status.
LIVE TESTING: Log in to your online banking and confirm a $0.01 credit.
Day 5: Refund
Refund the $0.01 Payment transaction.
Verify that the new transaction status is Accepted.
Day 6: Origination and Settlement
Verify Settled status.
LIVE TESTING: Log in to your online banking.
Verify receipt of a $0.01 debit.
Verify receipt of a $0.01 credit.
Test case 2: One-Off Payments for PPD, WEB
Repeat the steps from Test Case 1 (Creation, Origination, Waits, Settlement) using the following Standard Entry Codes and amounts:
PPD and $0.21
WEB and $0.22
Test case 3: One-Off Payout
Day 0: Creation
Create a CCD Payout for $0.30.
Verify that the new transaction status is Accepted.
Day 1: Origination
Verify Originated status.
LIVE TESTING: Log in to your online banking and confirm a $0.30 debit.
Day 2: Wait
No action required.
Day 3: Wait
No action required.
Day 4: Settlement
Verify Settled status.
LIVE TESTING: Log in to your online banking and confirm a $0.30 credit.
Test case 4: Voiding
Day 0: Creation & Voiding
Create a Payment for $0.40.
Verify that the new transaction status is Accepted.
Void the transaction before 6:00 PM ET on the same day.
Verify Voided status.
Test case 5: Normal Return
Day 0: Creation
Create a Payment for $0.60.
Set the Payment description as "Day2R01". (This will simulate an R01 - Insufficient Funds return on Day 2).
Verify that the new transaction status is Accepted.
Day 1: Origination
Verify Originated status.
Day 2: Return
After 10:00 AM ET, verify Returned status.
Test case 6: Late Return
Day 0: Creation
Create a Payment for $0.70 with the description as "Day5R10". (This will simulate an R10 - Customer Advises Unauthorized return on Day 5).
Verify that the new transaction status is Accepted.
Day 1: Origination
Verify Originated status.
Days 2-4: Wait
No action required.
Day 5: Return
After 10:00 AM ET, verify Returned status.
Testcase 7: Errors
Invalid Routing Number
Create a Payment for $0.80 using 770000000 as the routing number.
Verify the response is Errored status with the description "Customer Routing Number is not in master".
To begin testing Trace ACH, it must first be enabled on your sandbox account. If you do not currently have the ability to test Trace ACH, please reach out to developersupport@paytrace.com and request for it to be added to your sandbox for testing purposes.
Need More Help?
Our support team is always happy to assist you email us at developersupport@paytrace.com.
If you're unsure where to find information, use the search bar at the top right of any page.
If you can't find the documentation you're looking for, please let our support team know so we can continue to improve our resources.
Need more help?
Our support team will be happy to assist you.
If you are unsure where to go, try the search bar on the top right of any page.
If you cannot find the documentation you are looking for, please let our support team know so we can continue to improve this documentation.
If you have questions - please contact support@paytrace.com