Create a new bank account

curl -X POST https://api-sandbox.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/accounts \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Banking of the Corp",
  "kind": "BANK",
  "address": "0x123...",
  "network": "ETHEREUM",
  "accountNumber": "012342134-123",
  "routingNumber": "123456789",
  "isDefault": true,
  "currencySymbol": "ARS"
}'

{
  "id": "acc_6ead3cb5-e87f-4756-8389-8ad2f56757d0",
  "name": "Banking of the Corp",
  "entity": "Citibank NA",
  "kind": "BANK",
  "isVirtual": false,
  "address": "0x123...",
  "network": "ethereum",
  "type": "SAVINGS",
  "accountNumber": "012342134123",
  "routingNumber": "123456789",
  "countryId": "ctry_c7168583-0eeb-49b8-8c9b-0bffcf954fef",
  "currencyId": "cur_8289dc19-e775-4c0c-a42a-e0da129e3b64",
  "currencyCode": "ARS",
  "createdAt": "2024-07-01T22:40:22Z",
  "updatedAt": "2024-07-01T22:40:22Z",
  "isDefault": false,
  "isTracked": false,
  "merchantId": "mrc_31352afb-ce3a-4b7f-963d-b2512c646400",
  "contactId": "con_31352afb-ce3a-4b7f-963d-b2512c646400",
  "countryCode": "AR"
}

Creates a new bank account for the specified merchant. 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

merchantIdstringRequired

Merchant ID

organizationIdstringRequired

Organization ID

Request

This endpoint expects an object.

namestringRequired

kindenumRequired

Allowed values:

addressstringRequired

networkenumRequired

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

accountNumberstringRequired

routingNumberstringRequired

isDefaultbooleanRequired

currencySymbolenumRequired

entitystringOptional

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

isVirtualbooleanOptional

Whether this is a virtual account. Optional for all account types. Defaults to false if not provided.

typeenumOptional

Account type (SAVINGS, CHECKING, VIRTUAL). Optional for all account types. Defaults to VIRTUAL if not provided.

Allowed values:

isTrackedbooleanOptional

Whether this account is tracked for balance monitoring. Optional for all account types. Defaults to false if not provided.

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 bank account

Authentication

Path parameters

Headers

Request

Response

Errors