Create a new bank account

1 import requests 2 3 url = "https://api-test.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/accounts" 4 5 payload = { 6 "name": "Banking of the Corp", 7 "kind": "BANK", 8 "isVirtual": False, 9 "address": "0x123...", 10 "network": "ETHEREUM", 11 "type": "SAVINGS", 12 "accountNumber": "012342134-123", 13 "routingNumber": "123456789", 14 "isDefault": True, 15 "isTracked": True, 16 "currencySymbol": "ARS" 17 } 18 headers = { 19 "Authorization": "Bearer <token>", 20 "Content-Type": "application/json" 21 } 22 23 response = requests.post(url, json=payload, headers=headers) 24 25 print(response.json())

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 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:

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

Authentication

Path Parameters

Headers

Request

Response

Errors