DocsCreate an exchange session for an external party #
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.
HTTP request #
POST https://api.dwolla.com/external-parties/{id}/exchange-sessions
Request parameters #
| 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 and error codes #
| 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. |
Request and Response #
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
Previous
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.