Skip to main content
POST
Node.js
Required scope: transfers:write For a new transfer, use a pending, unexpired quote belonging to your business and keep enough available funds to cover it. This endpoint does not use Idempotency-Key. Save the quoteId and any reference you sent. After a timeout, retry with those same values and a fresh signature and timestamp. Once your credentials and business access are checked, a retry matching an existing quoteId or reference returns the original transfer. A reused reference with a new quoteId returns the original transfer and leaves the new quote unused. A reused quoteId with a new reference returns the original transfer without saving the new reference. If quoteId and reference identify different existing transfers, the response is 409 IDEMPOTENCY_CONFLICT. Concurrent retries do not create another transfer. A new quoteId with an unused reference, or without a reference, starts a new request. HTTP 201 means the request was accepted, not that funds were delivered. replayed=false identifies a new transfer; replayed=true identifies the original transfer returned without another payment. Follow GET /v1/transfers/ for the current outcome.

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.

Body

application/json
quoteId
string
required
reference
string
Maximum string length: 64

Response

Transfer created or the original transfer recovered. Acceptance does not mean payment completion.

status
string
required
Allowed value: "success"
replayed
boolean
required

True when the original resource is returned without creating another operation.

data
object
required

A transfer's progress and accepted fees. Use balanceImpact, when present, to check how funds were debited, reserved or refunded; processing status alone does not confirm those balance changes.

message
string