v33

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-03-2682193603.4 KB
sandbox simulations

Sandbox simulations (bank transfers, VAN transfers, or customer verification directives)

Sandbox-only endpoint with three modes:

Simulate bank transfer processing — Omit the body or send an empty JSON object. Processes or fails the last 500 bank transfers on the authorized application or Sandbox account (and initiated micro-deposits). If webhooks are configured, events are delivered. If a bank-to-bank transaction involves two users, call this twice to process debit and credit sides. Returns 200 with a HAL document including total.

Simulate VAN (virtual) transfers — Send a JSON body with type set to virtual and a transfers array (up to 10 items). External transfers are created and processed immediately. Returns 202 Accepted.

Simulate verification directives — For a business Verified Customer in retry or document status, send type: customer-verification, _links.customer.href pointing at that customer, and errorCode set to one of: PersonalIDRequired, POBoxNotAllowed, AddressNotAssociatedWithBusiness, EINDocumentRequired. Returns 200 with HAL _links.self and errorCode. Then GET the Customer; the same code appears in _embedded.errors for end-to-end testing.

post/sandbox-simulations

Headers

Accept'application/vnd.dwolla.v1.hal+json' required

The media type of the response. Must be application/vnd.dwolla.v1.hal+json

Response

Success. Bank transfer processing returns HAL with total. Customer verification directives return HAL _links.self and errorCode (retrieve the Customer for _embedded.errors).