Create a transfer
ReplaceQUOTE_ID with the ID returned when you created the quote:
quoteId is required. reference is optional and can contain up to 64 characters. Use a reference that identifies this payment in your system.
The quote must belong to your business, be pending and unexpired, and pass the current payment checks. Your available balance must cover totalSourceDebitAmount, including fees.
HTTP 201 means the request was accepted; processing can still fail later. Top-level replayed: false identifies a new transfer, and replayed: true identifies the original transfer returned without another payment. Save its ID and read GET /v1/transfers/{id} to check its current status. Conversions, external payouts and payments to Ledig businesses use this same flow.
Processing status
For a failed transfer, read
failureReason for the explanation and balanceImpact for the funds status. When returned, use customerPresentation.label, message and actionRequired to explain progress in your interface. approval can indicate that a payment is awaiting review.
The top-level status is the current result. Earlier events describe stages the transfer has already reached.
What happened to the funds
A failed transfer does not always mean the funds have already been returned. UsebalanceImpact when it is returned:
Its
lines give the amounts and currencies affected. If balanceImpact is missing, check your balances and contact support when you need help confirming the outcome.
Follow payment progress
PollGET /v1/transfers/{id}, leaving a delay between requests and increasing it while the payment remains pending. Honour Retry-After if you are rate limited.
Use the read endpoint instead of submitting the transfer again just to check its status. Use Transactions to list payment history.
A response may include receipt details or a crypto transaction hash. Use the transfer status and balanceImpact to confirm progress and the effect on your funds.
Retries
Transfers usequoteId and reference to recognise retries. This endpoint does not use the Idempotency-Key header.
After a timeout, retry with the same quote ID and original reference, using a fresh signature and timestamp. This returns the original transfer when one already exists. Do not create a new quote just to retry a payment whose outcome is unknown.
Retry recognition applies within the same business account. You still need valid authentication and an active business. An existing transfer can be retrieved through a retry even after its quote expires.
If the original outcome remains unclear, contact support@ledig.io with the transfer ID, quote ID and your reference. Keep those identifiers so support can find the original payment.