POST
/
bank-accounts
curl --request POST \
  --url https://api-test.koywe.com/rest/bank-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "bankCode": "BANK",
  "accountNumber": "123456789",
  "countryCode": "CHL",
  "currencySymbol": "CLP",
  "documentNumber": "<string>",
  "email": "<string>",
  "payoutMethodId": "<string>"
}'
{
  "_id": "63dd5fd9cccad469ee2408f7",
  "bankCode": "SANTANDER",
  "countryCode": "CHL",
  "currencySymbol": "CLP",
  "accountNumber": "1234596789",
  "account": "62f28c4aa05176c3dfba8e",
  "name": "BANCO SANTANDER"
}

For creating bank accounts in Colombia:

Itā€™s necessary to include the payoutMethodId. This ID represents the payout provider (https://docs.koywe.com/english/documentation/api-documentation/restful-api/Payout-provider/Returns-a-list-of-available-payout-providers-for-a-given-currency).

Additional indication: You can obtain the payout provider specific to Colombia by querying for the currency to be used, in this case COP.

Authorizations

Authorization
string
headerrequired

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

Body

application/json
bankCode
string
accountNumber
string
required
countryCode
string
required
currencySymbol
string
required
documentNumber
string
email
string
payoutMethodId
string

Currently being used only for Colombia, this optional field represents the payout provider.

Response

200 - application/json
_id
string
bankCode
string
countryCode
string
currencySymbol
string
accountNumber
string
account
string
name
string