API de pagamentos em stablecoins · USDT · USDC

Receba em USDT e USDC com uma única requisição.

Crie uma fatura, envie o comprador para um checkout hospedado ou monte o seu, e receba um webhook assinado assim que o pagamento é confirmado na Polygon, BNB Smart Chain ou Base. Feito para plataformas: cada pagamento pode ser dividido entre vendedores, parceiros e a sua margem.

Obter chaves de Sandbox Ler o início rápido

HTTP e JSON, sem SDK para instalar · 1,00 % por pagamento confirmado, até 0,50 %
Sandbox gratuito na Polygon Amoy, BSC Testnet e Base Sepolia

O dashboard do Aliquot no Sandbox: uma fatura paga de 492.00 USDT na Polygon Amoy, dividida entre Halden Type, Kerning Weekly, a margem da plataforma e a taxa do Aliquot, com a sua linha do tempo

Como funciona

Da fatura ao saldo em quatro passos. Você escreve o primeiro e o último.

01
Você cria uma fatura
Envie o valor, a rede e o token, e o id do seu pedido. A resposta traz o total exato, um endereço de depósito que só essa fatura usa e um pay_url.
POST /api/v1/crypto/invoices
02
O comprador paga
No checkout hospedado, na sua própria página com o endereço de depósito e a URI de pagamento, ou por um link de pagamento. Se você omitir a rede e o token, o comprador os escolhe no checkout.
/pay/:id · janela de 30 min
03
A rede confirma
O Aliquot monitora o endereço e conta as confirmações: 64 na Polygon, 15 na BNB Smart Chain, 30 na Base. Pagamentos a menos e a mais têm o seu próprio status.
PENDING → DETECTED → PAID
04
Webhook, livro-razão, saldo
invoice.paid chega ao seu endpoint assinado com HMAC-SHA256. O pagamento é lançado no livro-razão, e a parte de cada conta vira um saldo que você pode sacar para uma wallet.
invoice.paid · livro-razão · payouts

curl -X POST https://api.aliquot.cc/api/v1/crypto/invoices \
  -H "authorization: Bearer $ALIQUOT_API_KEY" \
  -H "content-type: application/json" \
  -H "idempotency-key: glyphyard-order-77310" \
  -d '{
    "amount": "100.00",
    "currency": "USD",
    "network": "POLYGON_AMOY",
    "token": "USDC",
    "fee_payer": "CUSTOMER",
    "markup_percent": 2,
    "merchant": "halden_type",
    "splits": [{ "account": "kerning_weekly", "percent": 10 }],
    "title": "Halden Grotesk — Desktop license, 5 seats",
    "merchant_order_id": "glyphyard-order-77310"
  }'

{
  "id": "inv_01JB7Q8M3X4K9TPZ2R6WVN5HDC",
  "status": "PENDING",
  "livemode": false,
  "network": "POLYGON_AMOY",
  "token": "USDC",
  "base": "100.00",
  "platform_fee": "1.00",
  "markup": "2.00",
  "merchant_net": "90.00",
  "total": "103.00",
  "deposit_address": "0x2830693ddff50d883cef82754913ea80c3c0b72e",
  "payment_uri": "ethereum:0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582@80002/transfer?address=0x2830693ddff50d883cef82754913ea80c3c0b72e&uint256=103000000",
  "required_confirmations": 64,
  "expires_at": "2026-10-26T14:32:11.000Z",
  "pay_url": "https://checkout.example/pay/inv_01JB7Q8M3X4K9TPZ2R6WVN5HDC",
  …
}

POST https://your-app.example/webhooks/aliquot
X-Webhook-Event: invoice.paid
X-Webhook-Signature: t=1793023552,v1=9c41e0…

{
  "id": "evt_9b1f4c2a7d3e8f6a5b0c1d2e",
  "type": "invoice.paid",
  "occurredAt": "2026-10-26T14:05:52.481Z",
  "data": {
    "invoice_id": "inv_01JB7Q8M3X4K9TPZ2R6WVN5HDC",
    "status": "PAID",
    "livemode": false,
    "merchant_order_id": "glyphyard-order-77310",
    "network": "POLYGON_AMOY",
    "token": "USDC",
    "amount_total": "103.00",
    "amount_received": "103.00",
    …
  }
}

Tudo o que você integra

Uma API. Cada peça do pagamento.

Checkout hospedado
Uma página de pagamento com QR code, botão de wallet e status em tempo real.
/pay/:id

API headless

Monte o seu próprio checkout com o endereço de depósito, o total e a URI de pagamento.

POST /api/v1/crypto/invoices

{
  "total": "103.00",
  "deposit_address": "0x2830…b72e",
  "payment_uri": "ethereum:0x41E9…",
  "expires_at": "…14:32:11Z"
}

Links de pagamento
Uma página de preço fixo que entrega um arquivo, um segredo ou um redirecionamento.
/l/:slug · sem código
Split de pagamento
Vendedor, parceiros, a sua margem e a nossa taxa, a partir de uma única fatura.
splits · markup_percent
Livro-razão de partidas dobradas
Cada pagamento é uma transação balanceada que você pode consultar.
GET …/crypto/ledger/transactions
Payouts com 2FA
Os saldos vão para uma wallet; pelo dashboard, com um código TOTP.
POST /api/v1/crypto/payouts
Webhooks assinados
Eventos assinados com HMAC, com até 7 tentativas e reenviáveis.
X-Webhook-Signature
Reembolsos por resgate
Pagamentos a mais e tokens errados aguardam em escrow até o comprador resgatá-los.
refund.claimable

Para plataformas e marketplaces

Divida cada pagamento. Um único lançamento, balanceado.

Adicione merchant, splits e markup_percent à fatura. Quando o pagamento é confirmado, o Aliquot lança a parte do vendedor, a de cada parceiro, a sua margem e a nossa taxa em uma única transação de partidas dobradas. Cada conta fica com o seu próprio saldo, pronto para um payout.

Cada parte é uma porcentagem do preço base, calculada em unidades inteiras do token. O vendedor absorve o arredondamento, então as partes sempre somam o total.
Com fee_payer CUSTOMER, a taxa e a sua margem são somadas ao preço. Com MERCHANT, o comprador paga 100.00 e as duas saem da parte do vendedor.
Os débitos igualam os créditos em toda transação, e o banco de dados garante isso. Os lançamentos só podem ser acrescentados e um saldo nunca fica negativo.

Livro-razão e splits →

Seu volume mensal

Preço100 USD

Sua margem2 %

Parte do parceiro10 %

Quem paga a taxa

O comprador paga103.00 USDC

Halden Type · vendedor90.00USDC
Kerning Weekly · parceiro · 10 %10.00USDC
Sua margem · 2 %2.00USDC
Aliquot · 1,00 %1.00USDC

A mesma divisão na requisição

"amount": "100.00",
"fee_payer": "CUSTOMER",
"markup_percent": 2,
"merchant": "halden_type",
"splits": [{ "account": "kerning_weekly", "percent": 10 }]

Calculado pelo mesmo motor de taxas do POST /api/v1/crypto/quote, em USDC com 6 casas decimais. Nomes de exemplo, não clientes.

O que você pode construir

Para plataformas que recebem por terceiros. E para as que recebem para si.

01
Marketplaces
Cada venda paga o vendedor, o afiliado que trouxe o comprador e a sua comissão, a partir de uma única fatura.
merchant · splits · markup_percent
02
SaaS e produtos digitais
Cobre por um plano, uma licença ou créditos, e libere o acesso no seu backend quando invoice.paid chegar.
merchant_order_id · invoice.paid
03
Plataformas de criadores
Um link de pagamento por produto que entrega um arquivo, um segredo ou um redirecionamento assim que o pagamento é confirmado.
/l/:slug
04
Comunidades no Telegram
Venda dentro do Telegram: o mesmo checkout hospedado abre como Mini-App.
/pay/:id?tg=1

Redes e confirmações

Três redes, duas stablecoins. Creditado a uma profundidade fixa.

Redes, tokens e limiares de confirmação suportados
Rede	Tokens	Confirmações	Espera típica	Sandbox
Polygon PoS	USDT · USDC	64	~2 min	Polygon Amoy · USDC
BNB Smart Chain	USDT (BEP-20, 18 casas decimais)	15	~45 s	BSC Testnet · USDT
Base	USDC	30	~1 min	Base Sepolia · USDC

Os limiares e as esperas são os do Live; o Sandbox pode confirmar a uma profundidade menor.

Polygon PoS64conf.USDT · USDC · ~2 minSandbox: Polygon Amoy · USDC
BNB Smart Chain15conf.USDT (BEP-20, 18 casas decimais) · ~45 sSandbox: BSC Testnet · USDT
Base30conf.USDC · ~1 minSandbox: Base Sepolia · USDC

Os limiares e as esperas são os do Live; o Sandbox pode confirmar a uma profundidade menor.

Como cuidamos do dinheiro

Cada unidade, contabilizada. Antes, durante e depois de se mover.

O banco de dados exige que feche
Pagamentos, varreduras, payouts e reembolsos são transações de partidas dobradas: os débitos igualam os créditos, os lançamentos só podem ser acrescentados e nenhum saldo fica negativo.
Docs →
Todo envio registrado antes
Cada transação de saída é gravada com o seu nonce e os seus bytes assinados antes de ser transmitida, então uma queda reenvia a mesma transação em vez de pagar duas vezes.
Docs →
2FA na saída de dinheiro
Um payout pelo dashboard pede um código TOTP, e criar uma API key que pode fazer payouts também.
Docs →
Chaves vinculadas ao seu ambiente
Uma chave do Sandbox (aq_sandbox_) não pode ver nem mover nada no Live, e uma do Live (aq_live_) não pode tocar no Sandbox.
Docs →

Antes de entrar em produção

O que um tech lead pergunta primeiro. Respondido de antemão.

Toda a documentação →

Quem fica com os fundos?

O Aliquot, até você sacá-los. Cada fatura tem o seu próprio endereço de depósito; assim que o pagamento é confirmado, ele é varrido para a wallet de envio do Aliquot, e o livro-razão registra a parte de cada conta. O dinheiro só sai como payout ou como reembolso.

Ver na documentação →

Como os vendedores recebem o dinheiro?

Com um payout do saldo disponível de uma conta para uma wallet. A taxa de payout, 1 USD mais 0,1 % do valor, é descontada do que é enviado. Um payout pelo dashboard pede um código TOTP, e criar uma API key que pode fazer payouts também.

Ver na documentação →

E se o meu endpoint estiver fora do ar?

Toda entrega é assinada (X-Webhook-Signature, HMAC-SHA256 sobre o body bruto). Se uma entrega falha, ela é repetida até completar 7 tentativas em cerca de 32 horas; cada tentativa fica registrada e pode ser reenviada, e você sempre pode conciliar com GET /api/v1/crypto/invoices.

Ver na documentação →

E se eu enviar a mesma requisição duas vezes?

O header Idempotency-Key é obrigatório em faturas e payouts. A mesma chave com o mesmo body devolve a mesma fatura, com Idempotent-Replay: true; a mesma chave com outro body é um 409.

Ver na documentação →

E se o comprador pagar o valor errado?

Pagamentos a mais, pagamentos parciais de uma fatura expirada, transferências atrasadas e o token errado ficam retidos em escrow. O comprador os resgata para uma wallet que ele controla por meio de um link privado. Nada é devolvido às cegas.

Ver na documentação →

Qual a diferença entre Sandbox e Live?

As chaves do Sandbox (aq_sandbox_…) rodam na Polygon Amoy, BSC Testnet e Base Sepolia com tokens de teste; as do Live (aq_live_…) movimentam stablecoins reais. Mesma API, mesmo livro-razão e mesmos webhooks, e uma chave só enxerga o seu próprio ambiente.

Ver na documentação →

Preços

1,00 %por pagamento confirmado, até 0,50 % com volume.

Sem planos e sem mensalidade. Você paga quando um pagamento é confirmado, a taxa diminui conforme o seu volume mensal cresce, e você soma a sua própria margem por cima.

Taxa de processamento por volume mensal
Volume mensal	Taxa sobre o preço base
Até 10.000 USD	1,00 %
10.000 – 50.000 USD	0,85 %
50.000 – 150.000 USD	0,70 %
150.000 – 500.000 USD	0,60 %
Acima de 500.000 USD	0,50 %

O volume é por organização: os pagamentos Live confirmados no mês. Vale a melhor faixa entre o mês passado e o mês atual até agora, e uma faixa nova se aplica às faturas criadas depois que você a atinge. Acima de 500.000 USD por mês, podemos combinar uma taxa com você.

Sua margem: De 0 a 20 %, creditada na conta da sua plataforma
Quem paga: fee_payer CUSTOMER ou MERCHANT, por fatura
Payouts: 1 USD + 0,1 % do payout, descontado do valor enviado
Reembolsos: Só o custo de rede, descontado do reembolso

Em uma venda de 100.00 a 1,00 %100.00 + 1.00

Obtenha chaves de Sandbox. Sua primeira fatura está a uma requisição de distância.

O Sandbox roda na Polygon Amoy, BSC Testnet e Base Sepolia, com a mesma API, o mesmo livro-razão e os mesmos webhooks do Live.

Programando com um agente de IA? Aponte-o para /llms.txt.

Obter chaves de Sandbox Ler o início rápido

Receba em USDT e USDC com uma única requisição.

Da fatura ao saldo em quatro passos. Você escreve o primeiro e o último.

Você cria uma fatura

O comprador paga

A rede confirma

Webhook, livro-razão, saldo

Uma API. Cada peça do pagamento.

Checkout hospedado

API headless

Links de pagamento

Split de pagamento

Livro-razão de partidas dobradas

Payouts com 2FA

Webhooks assinados

Reembolsos por resgate

Divida cada pagamento. Um único lançamento, balanceado.

Para plataformas que recebem por terceiros. E para as que recebem para si.

Marketplaces

SaaS e produtos digitais

Plataformas de criadores

Comunidades no Telegram

Três redes, duas stablecoins. Creditado a uma profundidade fixa.

Cada unidade, contabilizada. Antes, durante e depois de se mover.

O banco de dados exige que feche

Todo envio registrado antes

2FA na saída de dinheiro

Chaves vinculadas ao seu ambiente

O que um tech lead pergunta primeiro. Respondido de antemão.

1,00 %por pagamento confirmado, até 0,50 % com volume.

Obtenha chaves de Sandbox. Sua primeira fatura está a uma requisição de distância.