Sandbox Walkthrough
Overview
Welcome to the Newline Sandbox! Here we’ll show you how to build against the Newline API using the main features and admin tooling available in the Newline Sandbox.
Please note, the Newline Sandbox does not contain all of the features available in our Production environment. For clients interested in immediate access with a limited number of accounts, please reach out to your Relationship team.
Constraints
While the Sandbox will afford Client's opportunities to test key payments scenarios, the following features will be excluded and handled by our engineering teams
- Creation of Customers - any customer staged are business customers, with only name and address populated.
- Creation of
general
Synthetic Accounts - Anygeneral
Synthetic Accounts staged are master accounts with 1:1 relationships established to a Custodial Account; in addition, this Custodial Account represents a Commercial DDA. The staged Synthetic Accounts will have varying balances.
Sandbox vs. Production, environment differences
The Newline Sandbox endpoints enable clients to stage outcomes and interactions that are not available in production. The table below outlines some of the key differences between the sandbox and production environments.
API availability
Endpoint | Sandbox | Production |
---|---|---|
Synthetic Accounts | When creating a Synthetic Account of type ach_external , wire_external , instant_payments_external , no authentication is performed. The external account information provided will not initiate a connection to a financial institution. | When creating a Synthetic Account of type ach_external , wire_external , instant_payments_external , a valid account and routing number is required. The external account connection will be used to transfer funds to/from a financial institution. |
Transfers | Transfers to and from external accounts will be simulated. No real money movement will occur. | Transfer limits (frequency and volume) may exist based on the rules of your Program (e.g., 20 daily external transfers, a total daily $10,000 transfer limit). This will be discussed during Program onboarding. |
Mock Transactions | Transaction auto-generation exists to validate how externally originated transactions render on your application. These can be auto-generated using a Sandbox specific endpoint. | Unavailable in production. |
Virtual Reference Numbers (VRNs) | VRNs can be created off of any of the staged, general Synthetic Accounts. | Not currently in production (beta access only) |
Debit Cards | Debit Card interactions can be tested in Sandbox, all of which are simulated. No real card activity or payments will occur. | Not currently in production (beta access only) |
CSV Reporting availability
Newline's file-based reporting channel can be configured in Sandbox, if requested to your Newline Specialist during implementation.
Updated 3 months ago
If you feel comfortable with the onboarding information and Sandbox overview, please proceed to the API Authentication page to learn about access.