Create Deposit

Creates a PIX charge and returns the QR code for payment.

POST/v1/api/deposit

Request Body

Parameters

amountInCentsintegerRequired

Amount in cents (100 = R$1.00). Min 1, max 600000.

lbrlAddressstringRequired

Liquid address to receive L-BRL

lbrlSplitAddressstringOptional

Liquid address for split payment (requires splitFee)

splitFeestringOptional

Split percentage as "X.XX%". E.g. "2.99%" (requires lbrlSplitAddress)

Examples

Simple deposit

curl -X POST https://apilbrl.liqora.io/v1/api/deposit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer lqr_YOUR_TOKEN" \
  -d '{
    "amountInCents": 1000,
    "lbrlAddress": "tlq1qqwpzsxc3cuq3q7z9ywgsxe76sz77kqeyl4qj7wg2p5y4hjlwnfqt..."
  }'

Deposit with split

Split payments let you route a percentage of the net amount to a second Liquid address. Useful for marketplaces and platforms with commission fees.

curl -X POST https://apilbrl.liqora.io/v1/api/deposit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer lqr_YOUR_TOKEN" \
  -d '{
    "amountInCents": 10000,
    "lbrlAddress": "tlq1qq_main_address...",
    "lbrlSplitAddress": "tlq1qq_commission_address...",
    "splitFee": "2.99%"
  }'

Split payment

When a split is configured, Liqora sends the split amount directly to the split address in the same Liquid transaction. The remaining net amount goes to the primary address.

Response

Response fields

idstring (UUID)Required

Unique deposit ID

statusstringRequired

Current status: WAITING_PAYMENT

amountnumberRequired

Amount in BRL (e.g. 10.00)

amountInCentsintegerRequired

Original amount in cents

feeAmountnumberRequired

Liqora fee in BRL

netAmountnumberRequired

Net amount (amount - feeAmount)

qrCodestringRequired

QR Code image as base64 PNG

qrCodeTextstringRequired

PIX copy-paste string for payment

destinationAddressstringRequired

Destination Liquid address

splitAddressstring | nullRequired

Split address (null if not provided)

splitPercentnumber | nullRequired

Split percentage as decimal (0.0299 = 2.99%)

createdAtstring (ISO 8601)Required

Creation timestamp

Response201

{
  "id": "f1553ee9-7d4e-4d06-8c6e-3b944e361c75",
  "status": "WAITING_PAYMENT",
  "amount": 10,
  "amountInCents": 1000,
  "feeAmount": 0.1,
  "netAmount": 9.9,
  "qrCode": "iVBORw0KGgo...(base64 PNG)",
  "qrCodeText": "00020101021226710014br.gov.bcb.pix...",
  "destinationAddress": "tlq1qqwpzsxc3cuq3q7z9ywgsxe76sz...",
  "splitAddress": null,
  "splitPercent": null,
  "createdAt": "2026-02-12T08:40:19.307Z"
}

Errors

400

Validation Error

Invalid parameters (e.g. amountInCents out of range, splitFee without lbrlSplitAddress)

401

Unauthorized

Token is missing, invalid, or expired