This section details how to initiate Instant Account Verification for an external party 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/external-parties/{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/external-parties/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.