Create a new contact bank account

1 curl -X POST https://api-test.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/contacts/contactId/accounts \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "name": "Banking of the Corp", 6 "kind": "BANK", 7 "isVirtual": false, 8 "address": "0x123...", 9 "network": "ETHEREUM", 10 "type": "SAVINGS", 11 "accountNumber": "012342134-123", 12 "routingNumber": "123456789", 13 "isDefault": true, 14 "isTracked": true, 15 "currencySymbol": "ARS" 16 }'

1 { 2 "id": "acc_6ead3cb5-e87f-4756-8389-8ad2f56757d0", 3 "name": "Banking of the Corp", 4 "entity": "Citibank NA", 5 "kind": "BANK", 6 "isVirtual": false, 7 "address": "0x123...", 8 "network": "ethereum", 9 "type": "SAVINGS", 10 "accountNumber": "012342134123", 11 "routingNumber": "123456789", 12 "countryId": "ctry_c7168583-0eeb-49b8-8c9b-0bffcf954fef", 13 "currencyId": "cur_8289dc19-e775-4c0c-a42a-e0da129e3b64", 14 "currencyCode": "ARS", 15 "createdAt": "2024-07-01T22:40:22Z", 16 "updatedAt": "2024-07-01T22:40:22Z", 17 "isDefault": false, 18 "isTracked": false, 19 "merchantId": "mrc_31352afb-ce3a-4b7f-963d-b2512c646400", 20 "contactId": "con_31352afb-ce3a-4b7f-963d-b2512c646400", 21 "countryCode": "AR" 22 }

Creates a new bank account for the specified contact. Supports both fiat and crypto accounts with appropriate validation.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path Parameters

contactIdstringRequired

Contact ID

merchantIdstringRequired

Merchant ID

organizationIdstringRequired

Organization ID

Request

This endpoint expects an object.

namestringRequired

kindenumRequired

Allowed values:

isVirtualbooleanRequired

addressstringRequired

networkenumRequired

Blockchain network. Required for crypto accounts (kind=CRYPTO).

typeenumRequired

Allowed values:

accountNumberstringRequired

routingNumberstringRequired

isDefaultbooleanRequired

isTrackedbooleanRequired

currencySymbolenumRequired

entitystringOptional

Bank entity code. Optional for AR, MX, PE, BO, BR, US (auto-deduced). Required for CL, CO.

countrySymbolenumOptional

Country code. Required for fiat accounts (kind=BANK), optional/ignored for crypto accounts (kind=CRYPTO).

Response

idstring

namestring

entitystring

kindenum

Allowed values:

isVirtualboolean

addressstring

networkstring

typeenum

Allowed values:

accountNumberstring

routingNumberstring

countryIdstring

currencyIdstring

currencyCodestring

Currency symbol

createdAtdatetime

updatedAtdatetime

isDefaultboolean

isTrackedboolean

merchantIdstring

contactIdstring

countryCodestring or null

Two-letter ISO country code

Create a new contact bank account

Authentication

Path Parameters

Headers

Request

Response

Errors