Bank Accounts
Bank accout API
Introduction
The Bank Accounts API provides developers with functionality to manage and retrieve information related to bank accounts with their accounts.
- Bank Accounts:
- Retrieve a comprehensive list of bank accounts associated with a given API key.
- Access specific bank account details by querying with the bank account ID.
- Create new bank accounts by providing essential details in the request body.
- Deletes a specific bank account by providing the bank account ID.
Post Bank Account
POSThttps://api.adesic.com/v2/transactions/payment-methods
Create a new US bank account by providing the necessary account details. Upon a successful request, it returns a 201 status code along with the details of the created bank account.
Headers
| Name | Type | Description |
|---|---|---|
| apiKey* | string | Your Adesic API Key |
Request Body
| Name | Type | Description |
|---|---|---|
| bankAccount* | object | Bank account details. |
| bankAccount.achAccountNumber* | string | ACH account number. |
| bankAccount.achRoutingNumber* | string | ACH routing number. Must be exactly 9 numbers. |
| bankAccount.wireAccountNumber* | string | Wire account number. |
| bankAccount.wireRoutingNumber* | string | Wire routing number. Must be exactly 9 numbers. |
| bankAccount.rtpAccountNumber | string | RTP account number. Required only when bankAccount.rtpRoutingNumber is provided. |
| bankAccount.rtpRoutingNumber | string | RTP routing number. Required only when bankAccount.rtpAccountNumber is provided. Must be exactly 9 numbers. |
| bankAccount.type | string | Bank account type. One of CHECKING, SAVINGS, BUSINESS_CHECKING, or BUSINESS_SAVINGS. |
| bankAccount.fiatCurrency | string | Fiat currency. Must be USD when provided. |
| bankAccount.billingDetails* | object | Customer’s billing details. |
| bankAccount.billingDetails.city* | string | City in the billing address. |
| bankAccount.billingDetails.country* | string | Country in the billing address. Use US, USA, or UNITED_STATES. |
| bankAccount.billingDetails.line1* | string | Address line 1 in the billing address. |
| bankAccount.billingDetails.line2 | string | Address line 2 in the billing address. |
| bankAccount.billingDetails.province* | string | Two-letter US state or subdivision code. |
| bankAccount.billingDetails.fullName* | string | Full name of the billing contact. |
| bankAccount.billingDetails.phone | string | Phone number of the billing contact. |
| bankAccount.billingDetails.zip* | string | Five-digit ZIP code in the billing address. |
Response
201: Created Success
{
"id": "bac-123456788",
"achRoutingNumber": "021000021",
"wireRoutingNumber": "021000021",
"achAccountNumber": "67890",
"wireAccountNumber": "67890",
"bankName": "Bank of America",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781",
"userId": "usr-123456788",
"fiatCurrency": "USD",
"bankAddress": {
"city": "ORLANDO",
"country": "UNITED_STATES",
"line1": "1123 PROMANADE ST",
"line2": null,
"province": "FL",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781"
},
"billingDetails": {
"city": "BOSTON",
"country": "UNITED_STATES",
"line1": "342 MAIN ST",
"line2": "SUITE 100",
"province": "MA",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781",
"fullName": "GAVIN BELSON",
"phone": "1112223333",
"zip": "02142"
}
}Get Bank Accounts
GEThttps://api.adesic.com/v2/transactions/payment-methods
Retrieves all bank accounts associated with the provided API key. Upon a successful request, it returns a 200 status code and a list of bank accounts.
Headers
| Name | Type | Description |
|---|---|---|
| apiKey* | string | Your Adesic API Key |
Response
200: OK Success
[{
"id": "bac-123456788",
"achRoutingNumber": "021000021",
"wireRoutingNumber": "021000021",
"achAccountNumber": "67890",
"wireAccountNumber": "67890",
"bankName": "Bank of America",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781",
"userId": "usr-123456788",
"fiatCurrency": "USD",
"bankAddress": {
"city": "ORLANDO",
"country": "UNITED_STATES",
"line1": "1123 PROMANADE ST",
"line2": null,
"province": "FL",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781"
},
"billingDetails": {
"city": "BOSTON",
"country": "UNITED_STATES",
"line1": "342 MAIN ST",
"line2": "SUITE 100",
"province": "MA",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781",
"fullName": "GAVIN BELSON",
"phone": "1112223333",
"zip": "02142"
}
}]Get Bank Account by ID
GEThttps://api.adesic.com/v2/transactions/payment-methods/{bankAccountId}
Retrieves the details of a specific bank account using its unique bank account ID. Upon a successful request, it returns a 200 status code and the details of the requested bank account.
Headers
| Name | Type | Description |
|---|---|---|
| apiKey* | string | Your Adesic API Key |
Query Parameters
| Name | Type | Description |
|---|---|---|
| bankAccountId* | string | Bank Account Id |
Response
200: OK Success
{
"id": "bac-123456788",
"achRoutingNumber": "021000021",
"wireRoutingNumber": "021000021",
"achAccountNumber": "67890",
"wireAccountNumber": "67890",
"bankName": "Bank of America",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781",
"userId": "usr-123456788",
"fiatCurrency": "USD",
"bankAddress": {
"city": "ORLANDO",
"country": "UNITED_STATES",
"line1": "1123 PROMANADE ST",
"line2": null,
"province": "FL",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781"
},
"billingDetails": {
"city": "BOSTON",
"country": "UNITED_STATES",
"line1": "342 MAIN ST",
"line2": "SUITE 100",
"province": "MA",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781",
"fullName": "GAVIN BELSON",
"phone": "1112223333",
"zip": "02142"
}
}Delete Bank Account
DELETEhttps://api.adesic.com/v2/transactions/payment-methods/{bankAccountId}
Deletes a specified bank account using its unique bank account ID. Upon a successful request, it returns a 204 status code indicating that the bank account has been deleted.
Headers
| Name | Type | Description |
|---|---|---|
| apiKey* | string | Your Adesic API Key |
Query Parameters
| Name | Type | Description |
|---|---|---|
| bankAccountId* | string | Bank Account Id |
Response
204: No Content
No ContentCopy & Paste Code
POST Bank Accounts
cURL
curl -X POST \
-H "Content-Type: application/json" \
-H "api-key: your-api-key" \
-d '{
"bankAccount": {
"achAccountNumber": "67555234890",
"achRoutingNumber": "021000021",
"wireAccountNumber": "67555234890",
"wireRoutingNumber": "021000021",
"type": "CHECKING",
"fiatCurrency": "USD",
"billingDetails": {
"city": "Boston",
"country": "US",
"line1": "123 Bill Me Dr",
"province": "MA",
"fullName": "Frank Tester",
"phone": "123345456",
"zip": "02110"
}
}
}' \
https://api.adesic.com/v2/transactions/payment-methodsGET Bank Accounts
cURL
curl -H "api-key: YOUR_API_KEY" "https://api.adesic.com/v2/transactions/payment-methods"Bank Accounts Response Object
POST Bank Accounts
Example URL: https://api.adesic.com/v2/transactions/payment-methodsÂ
{
"id": "bac-123456788",
"achRoutingNumber": "021000021",
"wireRoutingNumber": "021000021",
"achAccountNumber": "67890",
"wireAccountNumber": "67890",
"bankName": "Bank of America",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781",
"userId": "usr-123456788",
"fiatCurrency": "USD",
"bankAddress": {
"city": "ORLANDO",
"country": "UNITED_STATES",
"line1": "1123 PROMANADE ST",
"line2": null,
"province": "FL",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781"
},
"billingDetails": {
"city": "BOSTON",
"country": "UNITED_STATES",
"line1": "342 MAIN ST",
"line2": "SUITE 100",
"province": "MA",
"createdAt": "2024-07-23T14:04:28.788",
"updatedAt": "2024-07-23T14:04:28.781",
"fullName": "GAVIN BELSON",
"phone": "1112223333",
"zip": "02142"
}
}Bank Accounts Response Attributes
| Attribute Name | Type | Description |
|---|---|---|
| id | string | Unique bank account id. |
| achRoutingNumber | string | ACH routing number. |
| achAccountNumber | string | ACH account number. |
| wireRoutingNumber | string | Wire routing number. |
| wireAccountNumber | string | Wire account number. |
| rtpRoutingNumber | string | RTP routing number, when configured. |
| rtpAccountNumber | string | RTP account number, when configured. |
| bankName | string | The bank name. |
| createdAt | string | The timestamp the bank account was created at. |
| updatedAt | string | The timestamp the bank account was updated at. |
| userId | string | Unique user id. |
| fiatCurrency | string | Fiat currency for the bank account. |
| bankAddress | object | Customer’s bank details. |
| bankAddress.city | string | City where the bank is located. |
| bankAddress.country | string | Country where the bank is located. |
| bankAddress.line1 | string | Address line 1 of the bank. |
| bankAddress.line2 | string | Address line 2 of the bank. |
| bankAddress.province | string | Province or state where the bank is located. |
| billingDetails | object | Customer’s billing details. |
| billingDetails.city | string | City in the billing address. |
| billingDetails.country | string | Country in the billing address. |
| billingDetails.line1 | string | Address line 1 in the billing address. |
| billingDetails.line2 | string | Address line 2 in the billing address. |
| billingDetails.province | string | Province or state in the billing address. |
| billingDetails.fullName | string | Full name of the billing contact. |
| billingDetails.phone | string | Phone number of the billing contact. |
| billingDetails.zip | string | ZIP code in the billing address. |