sinnusinnu

Cobrar via Pix em 5 minutos

Crie um link Pix, compartilhe o checkout hospedado e acompanhe a confirmação por webhook.

Ao final deste tutorial você terá um link de pagamento Pix ativo e uma URL de checkout pronta para enviar ao cliente.

Pré-requisitos

  • Uma conta Sinnu com acesso ao painel.
  • Uma API key sk_live_.... Veja Autenticação.
  • curl ou qualquer cliente HTTP instalado.

Passo 1: exporte sua chave

Guarde a chave numa variável de ambiente para não colá-la em cada comando:

bash
export SINNU_KEY="<SUA_CHAVE_DE_API>"

Passo 2: crie o link Pix

Cobre R$ 19,90 usando amountCents: 1990:

POST /api/payment-links
curl -X POST https://api.sinnu.com.br/api/payment-links \
  -H "Authorization: Bearer $SINNU_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Pedido Pix #1024",
    "description": "Compra na Loja Exemplo",
    "priceMode": "fixed",
    "amountCents": 1990,
    "methods": ["pix"],
    "maxInstallments": 1,
    "interestMode": "absorb",
    "status": "active",
    "threeDsMode": "always"
  }'

Passo 3: monte a URL do checkout

A resposta contém o slug. O checkout hospedado fica em https://pay.sinnu.com.br/<slug>.

Resposta 201
{
  "id": "0f5b3d0f-5b44-4f66-92c9-1e7d7c0f1234",
  "slug": "abcd1234",
  "title": "Pedido Pix #1024",
  "priceMode": "fixed",
  "amountCents": 1990,
  "methods": ["pix"],
  "maxInstallments": 1,
  "interestMode": "absorb",
  "status": "active",
  "threeDsMode": "always",
  "createdAt": "2026-06-12T12:00:00.000Z",
  "updatedAt": "2026-06-12T12:00:00.000Z"
}
Link para o cliente
https://pay.sinnu.com.br/abcd1234

Passo 4: acompanhe a confirmação

Quando o cliente pagar, a Sinnu envia um webhook como transaction.approved. Configure a URL no painel e siga o tutorial Conciliar pagamentos com webhooks.

Pronto

Você criou seu primeiro link Pix. Veja a referência da API para todos os campos de link, clientes e transações.