Improved
v1.0.13
about 1 month ago by Mário Oliveira
institution_name is now optional
institution_name is now optionalThe endpoints below have been simplified, the institution_name field is no longer required when creating external accounts. We now automatically resolve the correct bank name using the institution_id, reducing failures due to mismatches on bank names.
Affected endpoints:
POST /v1/customers/{customer_id}/external-accounts
POST /v1/customers/{customer_id}/external-accountsPOST /v1/customers/{customer_id}/recipients/{recipient_id}/bank-accounts
POST /v1/customers/{customer_id}/recipients/{recipient_id}/bank-accountsPOST /v1/customers/{customer_id}/recipients (with inline bank_accounts)
POST /v1/customers/{customer_id}/recipients (with inline bank_accounts)No breaking changes — existing integrations that already send
institution_namewill continue to work as before.
Request example:
{
"network": "US_ACH",
"currency": "USD",
"country_code": "USA",
"account_number": "123456789",
"institution_id": "021000021"
}The response will include the resolved institution_name:
{
"institution_id": "021000021",
"institution_name": "JPMorgan Chase Bank, N.A.",
...
}New error code:
| Code | Status | Description |
|---|---|---|
00020008 | 400 Bad Request | Institution not found for the provided routing code. |
