How to use this API correctly#
Use EXACTLY ONE of the following amount parameters:
Only depositAmountInCents if you want to specify the amount you want to send in DePix.
OR only payoutAmountInCents if you want to specify the amount you want to receive in Pix (Reais).
From 01/05/2026, all withdrawal requests must include the beneficiary identification.
taxNumber: the CPF or CNPJ of the Pix key owner.
euid: the Eulen User Identification.
taxNumber nor euid is provided.If both taxNumber and euid are provided, the informed taxNumber must match the corresponding euid. If they do not match, the request will be rejected.The Pix key must belong to the informed taxNumber.If the Pix key ownership does not match the provided identification, the withdrawal may be automatically rejected by the banking system.
Send refundAddress if you want the DePix back when a payout cannot be completed.
refundAddress is an optional Liquid address, and it is where your DePix is returned if this withdrawal cannot go through.It has to be declared here, on the request, because it cannot be recovered afterwards. Liquid is a confidential chain and does not reveal who sent a transaction, so there is no way for us to work out where the DePix came from. A withdrawal created without refundAddress can still be refunded, but only after our team reaches you to ask for an address, and the funds stay put until that happens.Any Liquid address you control works, including the one you send the DePix from.
Maximum 128 characters, no spaces. The address is checked when the request is made; an invalid one is rejected with invalid 'refundAddress' param, and a non-string value with 'refundAddress' should be a string.
The recorded value comes back on GET /api/withdraw-status, so you can confirm what was stored.
What returns is DePix on the Liquid Network. It is never Reais, and it never reaches the beneficiary's Pix key. The withdrawal then reports the refunded status, listed on Possible Statuses. Never ever deposit after the expiration date.YOU WILL LOSE YOUR FUNDS!
