At the beginning of the year we made enhancements to our Sandbox environment that focused on simplifying the development experience for developers integrating with Dwolla. Today, we’re announcing updates to the Sandbox environment that will provide clarity for new and existing developers in the Dwolla community. These updates include:
- Replacing “uat” in the subdomain of public facing and API URLs with “sandbox”
- Sunsetting the Sandbox Console tool which exists at “https://sandbox-uat.dwolla.com/”
Developers are encouraged to review the impact of these updates and plan according to the following timelines:
Sandbox subdomain change timeline:
API consumers will need to update the API base URL to point to: https://api-sandbox.dwolla.com instead of https://api-uat.dwolla.com and https://sandbox.dwolla.com instead of https://uat.dwolla.com for API v2 and API v1 respectively. The subdomain change will be released in a phased approach over the next 3 months.
- Phase 1: Both new and old URLs will be supported in parallel beginning today. Public facing web URLs will begin redirecting today.
- Phase 2: Requests to the existing “uat” subdomain will no longer work beginning on June 29th, 2017.
Sandbox Console deprecation timeline:
- Due to low usage, and given there’s a much better alternative, we’ve decided to deprecate the Sandbox Console tool in order to reduce clutter and confusion. The Sandbox Console will sunset on April 27th, 2017.
What updates do I need to make for the subdomain change?
Changes have been released to the Dwolla supported API helper libraries. If you’re using an external REST client for making calls to Dwolla, then updates will need to be made prior to June 29th, 2017. Please reference our API documentation as they have been updated to reflected this change.
What are alternatives to the Sandbox Console?
If you’re integrating with Dwolla’s API:
The Sandbox Dashboard allows you to manage Customers, as well as transfers associated with the Customers that belong to your Sandbox account. Once your application has created its Customers, you can access the Sandbox Dashboard to validate that the request was recorded properly in our test environment.
Simulate bank transfer processing for Dwolla Customers
There are two options available to simulate bank transfer processing:
A “Process bank transfers” button is available in the Sandbox Dashboard. This button allows you to simulate bank transfer processing in the Sandbox. Once the button is clicked, Dwolla will process or fail the last 500 bank transfers that occurred on your Sandbox account or the Customer accounts you manage.
Alternatively, the same function as the “Process bank transfers button” can be performed via our API using an application access token. Make the following call to the Dwolla API to simulate bank transfer processing:
POST https://api-sandbox.dwolla.com/sandbox-simulations
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer {{applicationAccessToken}}
Content: application/json
If you’re integrating with Dwolla’s Transfer solution:
Unlike the with the API, you are unable to programmatically create accounts from your application. Your application will create test Dwolla accounts using Dwolla’s OAuth account creation experience. Once the test accounts have been created, your application can facilitate a transfer of funds to, from, or between test accounts once authorization is obtained via OAuth.
Simulate bank transfer processing for Transfer accounts
The ability to simulate bank transfer processing for traditional test accounts in our Sandbox environment has been made available through the API. Using the OAuth account access token which belongs to the full Dwolla test account involved in the transaction, you’ll call the API to simulate bank transfer processing. Make the following call to the Dwolla API to simulate bank transfer processing:
POST https://api-sandbox.dwolla.com/sandbox-simulations
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer {{accountAccessToken}}
Content: application/json
Reach out!
Need help making these updates? Have questions? We’re more than happy to help, so please don’t hesitate to reach out on our developer forums!
We'll help you design your ideal payments experience. We’ve sent you a message to kick off the conversation with our team. Please check your inbox. There was an error and the form was not submitted.Get started with ACH transfers
Thanks!
Sorry