Skip to main content
POST
/
users
/
bank-accounts
/
save
Save a bank account for a user (raw entry)
curl --request POST \
  --url https://api.sdev.banking.ingopayments.tech/api/v4/users/bank-accounts/save \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "api_key": "YOUR_API_KEY",
  "user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
  "idempotent_key": "idp-9f1a2b3c-4d5e-6f70-8192-a3b4c5d6e7f8",
  "first_name": "Alex",
  "last_name": "Rivera",
  "account_number": "8001234567",
  "routing_number": "123456789"
}
'
{
  "status": "success",
  "message": "operation completed",
  "data": {
    "items": [
      {
        "id": "bbac-...",
        "account_number_last_4": "6789",
        "routing_number": "123456789",
        "bank_name": "<string>",
        "created_at": "2026-04-16T12:34:56.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total": 100,
      "sort": "created_at:desc",
      "search": "jane"
    }
  }
}

Authorizations

​
api_key
string
header
required

Program API key identifying your integration. Pass as the api_key HTTP header (preferred) or as an api_key field in the JSON request body. Required on every request in addition to the HMAC Authorization header.

Body

application/json
​
user_id
string
required

Identifier of the target user. Required when the endpoint operates on a specific user.

Example:

"user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef"

​
idempotent_key
string
required

Client-supplied idempotency token. Submitting the same key twice returns the first response rather than creating a duplicate transaction.

​
first_name
string
required

First name.

​
last_name
string
required

Last name.

​
account_number
string
required

Bank account number (5-20 digits).

​
routing_number
string
required

ABA routing number (9 digits).

​
api_key
string

Program API key. Accepted either in the api_key HTTP header or as this body field.

​
postal_code
string

5-digit US ZIP code.

​
country
string

ISO 3166-1 alpha-2 country code.

​
state
string

ISO 3166-2 two-letter state/region code.

​
city
string

City.

​
address_one
string

Street address line 1.

​
fingerprint
string

Tokenised fingerprint representing the linked account.

Response

Success.

​
status
enum<string>
required
Available options:
success
​
message
string
required
Example:

"operation completed"

​
data
object

Endpoint-specific payload; shape varies per operation.