Create a new contact bank account

1 import requests 2 3 url = "https://api.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/contacts/contactId/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:22.003Z", 16 "updatedAt": "2024-07-01T22:40:22.003Z", 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

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

createdAtstringformat: "date-time"

updatedAtstringformat: "date-time"

isDefaultboolean

isTrackedboolean

merchantIdstring

contactIdstring

countryCodestring or null

Two-letter ISO country code

Authentication

Path parameters

Request

Response

Errors