This section details how to initiate Instant Account Verification for a customer using Dwolla's trusted open banking partners. You can trigger this process by creating an exchange session. There are two supported partners currently available: Visa and MX.
To create an exchange session, you'll need to provide a _link that identifies the specific open banking ecosystem partner you want to connect with. You can retrieve a list of available partners and their corresponding _link values by calling the list exchange partners endpoint. This endpoint will return a JSON response containing details about each partner, including their name and the unique _link identifier you'll need for this API call.
POST https://api.dwolla.com/customers/{id}/exchange-sessions
Property | Required | Type | Description |
---|---|---|---|
_links | yes | object | HAL-JSON link that represents the Exchange Partner resource that identifies the open banking provider used for creating an exchange. |
HTTP Status | Code | Description |
---|---|---|
201 | Created | The Dwolla API accepted the request and created an exchange session resource. You can reference the Location header to retrieve a link that represents the created exchange session resource. |
400 | ValidationError | Validation error(s) present. See embedded errors list for more details. |
401 | InvalidScope | Missing or invalid scopes for requested endpoint. |
404 | NotFound | The requested resource was not found. |
POST https://api.dwolla.com/customers/74a207b2-b7b7-4efa-8bf8-582148e7b980/exchange-sessions
Accept: application/vnd.dwolla.v1.hal+json
Content-Type: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY
{
"_links": {
"exchange-partner": {
"href": "https://api.dwolla.com/exchange-partners/292317ec-e252-47d8-93c3-2d128e037aa4"
}
}
}
HTTP/1.1 201 Created
Location: https://api.dwolla.com/exchange-sessions/fcd15e5f-8d13-4570-a9b7-7fb49e55941d
All funds transfers made using the Dwolla Platform are performed by a financial institution partner, and any funds held in a Dwolla Balance are held by a financial institution partner. Learn more about our financial institution partners.