Transfer Methods
The following endpoints are use to manage and retrieve the transfer methods on the system.
DELETE /transfer-methods/:idGET /transfer-methods/:idGET /transfer-methodsPOST /transfer-methods
This API provides transfer method management functionalities.
Name | Type | Description | Constraints |
|---|---|---|---|
appId | String | Application ID. Format: uuid. | |
createdAt | DateTime | Transfer method created at date. | Not Null |
deletedAt | DateTime | Transfer method deleted at date. | |
externalReference | String | Transfer method external reference. | |
id | String | Transfer method identifier. Format: uuid. | Not Null |
identityId | String | Transfer method identity owner. Format: uuid | |
metadata | Object | Transfer method metadata. | |
type | String | Transfer method type. | Enum:[ ach, internationalWire, wire] |
updatedAt | DateTime | Transfer method updated at date. | Not Null |
DELETE /transfer-methods/:idDelete transfer method by id.
Response Options
400 Bad Request
- validation_failed
- If id is invalid.
404 Not Found
- transfer_method_not_found
204 OK
Request example:
DELETE <hostname>/transfer-methods/e7941059-74c6-4b3f-b029-d3aa03d1ea44
GET /transfer-methods/:idGet transfer method by id.
Response Options
400 Bad Request
- validation_failed
- If id is invalid.
404 Not Found
- transfer_method_not_found
200 OK
Request example:
GET <hostname>/transfer-methods/e7941059-74c6-4b3f-b029-d3aa03d1ea44
Response example:
{
"data": {
"appId": "e7941059-74c6-4b3f-b029-d3aa03d1ea44",
"createdAt": "2020-10-28T17:40:55.501Z",
"deletedAt": null,
"externalReference": null,
"id": "e7941059-74c6-4b3f-b029-d3aa03d1ea44",
"identityId": "e7941059-74c6-4b3f-b029-d3aa03d1ea44",
"metadata": {
"bankName": "Royal bank",
"swiftCode": "BKBKESMMXXX",
"bankAccountName": "foobar",
"bankAccountNumber": "GB94BARC10201530093459"
},
"type": "internationalWire",
"updatedAt": "2020-10-28T17:40:55.501Z"
}
}
GET /transfer-methodsGet transfer methods list.
Available filters
Name | Type | Example |
|---|---|---|
externalReference | default,in,nin | filter[externalReference]=foobar |
id | default,in,nin | filter[id]=foobar |
identityId | default,in,nin | filter[identityId]=foobar |
type | default,in,nin | filter[type]=in:foobar |
Available sorts
Name | Example |
|---|---|
createdAt | sort=createdAt
sort=-createdAt |
updatedAt | sort=updatedAt
sort=-updatedAt |
Paginate options
Name | Description | Example |
|---|---|---|
size | Defines the number of results per page. Default = 30. | page[size]=2 |
number | Defines the number of the page to retrieve. Default = 1 | page[number]=2 |
all | Return all identities without pagination | all=true |
Response Options
200 OK
Request example:
GET <hostname>/transfer-methods
Response example:
{
"data": [{
"appId": "e7941059-74c6-4b3f-b029-d3aa03d1ea44",
"createdAt": "2020-10-28T17:40:55.501Z",
"deletedAt": null,
"externalReference": null,
"id": "e7941059-74c6-4b3f-b029-d3aa03d1ea44",
"identityId": "e7941059-74c6-4b3f-b029-d3aa03d1ea44",
"metadata": {
"bankName": "Royal bank",
"swiftCode": "BKBKESMMXXX",
"bankAccountName": "foobar",
"bankAccountNumber": "GB94BARC10201530093459"
},
"type": "internationalWire",
"updatedAt": "2020-10-28T17:40:55.501Z"
}],
"total": 1
}
POST /transfer-methodsCreates a transfer method.
Request Parameters
Body parameters for type internationalWire
Name | Type | Description | Constraints | Required |
|---|---|---|---|---|
bankAccountName | String | Bank account name amount. | Not null | true |
bankAccountNumber | String | Bank account number. | Valid IBAN | true |
bankName | String | Bank name. | Not null | true |
identityId | String | Identity identification. Format: uuid | | true |
swiftCode | String | Swift code. | Valid swift code. | true |
type | String | Transfer method. | internationalWire | true |
Body parameters for type wire
Name | Type | Description | Constraints | Required |
|---|---|---|---|---|
bankAccountName | String | Bank account name amount. | Not null | true |
bankAccountNumber | String | Bank account number. | Valid US acccount number | true |
identityId | String | Identity identification. Format: uuid | | true |
routingNumber | String | Routing number. | Valid routing number. | true |
type | String | Transfer method. | wire | true |
Body parameters for type ach
Name | Type | Description | Constraints | Required |
|---|---|---|---|---|
plaidAccessToken | String | Plaid access token. | Not null | true |
plaidAccountId | String | Plaid account id. | Not null | true |
identityId | String | Identity identification. Format: uuid | | true |
type | String | Transfer method. | ach | true |
Body parameters for type pix
Name | Type | Description | Constraints | Required |
|---|---|---|---|---|
document | String | Document id. | Not null | true |
identityId | String | Identity identification. Format: uuid | | true |
type | String | Transfer method. | pix | true |
Response Options
400 Bad Request
- validation_failed
- If the required parameters are not provided.
- If additional parameters are provided.
- If some of the parameters type is invalid.
- If some of the parameters constraints is not respected.
200 OK
Request example:
POST <hostname>/transfer-methods
{
"bankAccountName": "foobar",
"bankAccountNumber": "GB94BARC10201530093459",
"bankName": "Royal bank",
"identityId": "87e5d63a-c92a-4f2f-a869-bb7119d0f0a0",
"swiftCode": "BKBKESMMXXX" ,
"type": "internationalWire"
}
Response example:
{
"data": {
"appId": "e86755c5-f997-443e-992c-67f2866278aa",
"createdAt": "2022-06-09T18:08:27.604Z",
"deletedAt": null,
"externalReference": "76559632-442a-4a78-89e3-b4960cf0cd73",
"id": "8471e769-5bc3-4531-a320-bdcab1ceea50",
"identityId": "87e5d63a-c92a-4f2f-a869-bb7119d0f0a0",
"metadata": {
"bankName": "Royal bank",
"swiftCode": "BKBKESMMXXX",
"bankAccountName": "foobar",
"bankAccountNumber": "GB94BARC10201530093459"
},
"type": "internationalWire",
"updatedAt": "2022-06-09T18:08:29.211Z"
}
}
Last modified 7mo ago