Open an account for a ready customer - Element Pay Partner API

curl --request POST \
  --url https://sandbox.elementpay.net/api/v1/partner/customers/{customer_id}/accounts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "asset_type": "fiat",
  "currency": "EUR"
}
'

{
  "status": "success",
  "message": "Account already exists",
  "data": {
    "id": 18,
    "customer_id": "pcus_a1b2c3d4e5f6",
    "asset_type": "fiat",
    "currency": "EUR",
    "network": null,
    "status": "active",
    "display_name": "EUR",
    "account_number": "DE89370400440532013000",
    "bank_name": "Example Bank",
    "swift_bic": "COBADEFFXXX",
    "balance": {
      "available": "250.00",
      "currency": "EUR"
    },
    "created_at": "2026-08-01T12:00:00+00:00"
  }
}

{
  "status": "success",
  "message": "Account opened",
  "data": {
    "id": 18,
    "customer_id": "pcus_a1b2c3d4e5f6",
    "asset_type": "fiat",
    "currency": "EUR",
    "network": null,
    "status": "active",
    "display_name": "EUR",
    "account_number": "DE89370400440532013000",
    "bank_name": "Example Bank",
    "swift_bic": "COBADEFFXXX",
    "balance": {
      "available": "250.00",
      "currency": "EUR"
    },
    "created_at": "2026-08-01T12:00:00+00:00"
  }
}

{
  "status": "error",
  "message": "Deposit account is not ready",
  "data": {
    "deposit_account_status": "pending"
  }
}

POST

partner

customers

{customer_id}

accounts

curl --request POST \
  --url https://sandbox.elementpay.net/api/v1/partner/customers/{customer_id}/accounts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "asset_type": "fiat",
  "currency": "EUR"
}
'

{
  "status": "success",
  "message": "Account already exists",
  "data": {
    "id": 18,
    "customer_id": "pcus_a1b2c3d4e5f6",
    "asset_type": "fiat",
    "currency": "EUR",
    "network": null,
    "status": "active",
    "display_name": "EUR",
    "account_number": "DE89370400440532013000",
    "bank_name": "Example Bank",
    "swift_bic": "COBADEFFXXX",
    "balance": {
      "available": "250.00",
      "currency": "EUR"
    },
    "created_at": "2026-08-01T12:00:00+00:00"
  }
}

{
  "status": "success",
  "message": "Account opened",
  "data": {
    "id": 18,
    "customer_id": "pcus_a1b2c3d4e5f6",
    "asset_type": "fiat",
    "currency": "EUR",
    "network": null,
    "status": "active",
    "display_name": "EUR",
    "account_number": "DE89370400440532013000",
    "bank_name": "Example Bank",
    "swift_bic": "COBADEFFXXX",
    "balance": {
      "available": "250.00",
      "currency": "EUR"
    },
    "created_at": "2026-08-01T12:00:00+00:00"
  }
}

{
  "status": "error",
  "message": "Deposit account is not ready",
  "data": {
    "deposit_account_status": "pending"
  }
}

Authorizations

X-API-Key

string

header

required

Partner API key. Sandbox keys start with is_test_; production keys start with is_live_. Keys are not interchangeable across environments. Send on every request. Never expose in browser or mobile clients.

Path Parameters

customer_id

string

required

Public customer id returned by POST /partner/customers

Example:

"pcus_a1b2c3d4e5f6"

Body

application/json

asset_type

string

required

fiat or stablecoin

Example:

"fiat"

currency

string

required

Example:

"EUR"

network

string

Required for stablecoin: Base or Polygon

Example:

"Base"

display_name

string

Example:

"EUR operating"

Response

Successful Response

The response is of type object.