Liqora API

Integrate PIX payments with instant L-BRL settlement on the Liquid Network.

Overview

The Liqora API lets partners create PIX charges programmatically. When the payer completes the PIX, Liqora automatically sends L-BRL (a Brazilian Real stablecoin on the Liquid Network) to the partner's Liquid address.

Base URL

apilbrl.liqora.io/v1/api

Authentication

Bearer Token via Telegram Bot

Format

JSON request and response bodies

Quick Start

1. Generate an API token

In the Telegram group linked to your partner account, run:

/apitoken myapp 30 deposit

This generates a token valid for 30 days with deposit scope. The token is shown only once — copy and store it securely.

2. Create a 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": "tlq1qq..."
  }'

3. Show the QR Code to the payer

The response includes qrCode (base64 PNG image) and qrCodeText (PIX copy-paste string). Display the QR code for the payer to scan.

4. Receive a notification

Once the PIX is confirmed and L-BRL is sent to your Liquid address, Liqora fires a deposit.completed webhook to your registered URL.

Flow

1Partner calls POST /deposit

2Liqora creates a PIX charge (QR Code + copy-paste string)

3Payer scans and pays via PIX

4Liqora confirms and sends L-BRL on the Liquid Network

5Webhook deposit.completed sent to partner

L-BRL

L-BRL is a stablecoin pegged 1:1 to the Brazilian Real, issued on the Liquid Network (a Bitcoin sidechain). Each L-BRL is fully backed by BRL held in segregated accounts.

Authentication