Create a new bank account

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

Path parameters

merchantIdstringRequired

Merchant ID

organizationIdstringRequired

Organization ID

Request

This endpoint expects an object.

namestringRequired

entitystringRequired

kindenumRequired

Allowed values:

isVirtualbooleanRequired

addressstringRequired

networkstringRequired

typeenumRequired

Allowed values:

accountNumberstringRequired

routingNumberstringRequired

isDefaultbooleanRequired

isTrackedbooleanRequired

countrySymbolenumRequired

currencySymbolenumRequired

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

Path parameters

Headers

Request

Response

Errors