Skip to main content
POST
Node.js
Required scope: fiat_wallet Send the currency and an Idempotency-Key. Retrying the same request returns the original result; reusing the key with changed inputs returns 409. Your business must have access to receiving accounts and permission to create them. HTTP 200 means the account is ready; HTTP 202 means the request is pending. Keep the original key when checking or retrying the request.

Authorizations

x-ledig-key
string
header
required

Your business API key ID. Keep its secret on your server and use that secret to sign each request.

x-ledig-timestamp
string
header
required

The current Unix timestamp in seconds, used in the signed request.

x-ledig-signature
string
header
required

The request's HMAC-SHA256 signature. Use the v1= prefix for supported own-business requests, or v2= when acting for a managed business with signed business-selection headers. Follow the authentication guide to construct and sign the exact request.

Headers

Idempotency-Key
string
required

A unique value for this request. On endpoints that require it, retry with the same key and identical inputs to avoid creating the operation twice.

Body

application/json
currency
string
required
Required string length: 1 - 10
provider
string
Required string length: 1 - 30
accountName
string
Required string length: 1 - 100
intent
enum<string>
Available options:
resume,
additional

Response

The issued account or the original completed result.

status
string
required
Allowed value: "success"
data
object
required

Your business's bank receiving details and funding instructions.

message
string