Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stric.io/llms.txt

Use this file to discover all available pages before exploring further.

Receber um Pix pela Stric costuma seguir um destes cenários:
  • Cobrança com QR Code: você cria uma cobrança, exibe o QR ao pagador e concilia quando ela for paga (pix.charge.paid).
  • Pix recebido pela chave da conta (sem cobrança prévia): não há endpoint REST para “caixa de entrada” de Pix nesta API — use o webhook pix.in.received como fonte principal e o extrato / movimentos para conferência.

​
Caminho A — cobrança com QR Code

​
1. Criar a cobrança

curl -X POST "$STRIC_BASE_URL/v1/charges" \
  -H "Authorization: Bearer $STRIC_API_KEY" \
  -H "Idempotency-Key: charge-pedido-12345" \
  -H "Content-Type: application/json" \
  -d '{
    "variant": "simple",
    "amountCents": "5000",
    "tag": "mensalidade-janeiro-2026"
  }'
A resposta traz o BR Code (string para QR) e a URL de pagamento.

​
2. Exibir o QR para o pagador

Renderize a string do BR Code como QR Code visual no seu front-end. Bibliotecas como qrcode (Node) ou qrcode (Python) fazem o trabalho.

​
3. Receber confirmação

Assine pix.charge.paid no webhook da conta para ser notificado em segundos quando a cobrança for paga — veja o payload em Webhooks.

​
4. Listar e auditar

# Cobranças com filtros
curl "$STRIC_BASE_URL/v1/charges?status=PAID&limit=50" \
  -H "Authorization: Bearer $STRIC_API_KEY"

# Detalhe de uma cobrança específica
curl "$STRIC_BASE_URL/v1/charges/$CHARGE_ID" \
  -H "Authorization: Bearer $STRIC_API_KEY"

​
Caminho B — Pix recebido pela chave (sem cobrança prévia)

Quando alguém envia Pix direto para uma chave Pix cadastrada na sua conta sem você ter criado cobrança antes:
  1. Notificação: cadastre um webhook e assine pix.in.received — em data vêm valor, endToEndId, pagador, etc. Veja exemplos em Webhooks.
  2. Auditoria / backup: use GET /v1/statement (lista paginada de movimentos) e GET /v1/movements/{id} quando você já souber o id do movimento. Consulte a referência Movements no OpenAPI para filtros (from, to, type, source, etc.).
O endToEndId (em data no webhook pix.in.received) é o identificador único do Pix no arranjo — priorize ele na conciliação com o seu ledger.

​
Boas práticas de conciliação

Webhooks são entregues em segundos após o evento. Polling no extrato é backup, não o fluxo principal.
Salve o evento bruto no seu banco antes de aplicar a lógica. Se algo falhar, você pode reprocessar sem perder dados.
O webhook pode chegar mais de uma vez. Deduplique por campos estáveis em data (ex.: endToEndId) ou por eventId, quando a plataforma incluir no corpo.
Mesmo com webhooks confiáveis, rode reconciliação rotineira contra GET /v1/charges (cobranças) e GET /v1/statement / movimentos (Pix sem cobrança) batendo com seu banco.