sinnusinnu

Criar um link de pagamento

Gere um checkout hospedado por Pix ou cartão de crédito com uma chamada à API.

Endpoint

Use POST /api/payment-links para criar um link de pagamento. O campo methods define as formas aceitas:

  • pix: pagamento instantâneo via Pix.
  • credit_card: cartão de crédito, com parcelamento até 12x.

Pix

Link Pix
curl -X POST https://api.sinnu.com.br/api/payment-links \
  -H "Authorization: Bearer <SUA_CHAVE_DE_API>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Pedido #1024",
    "description": "Compra na Loja Exemplo",
    "priceMode": "fixed",
    "amountCents": 12990,
    "methods": ["pix"],
    "maxInstallments": 1,
    "interestMode": "absorb",
    "status": "active",
    "threeDsMode": "always",
    "redirectUrl": "https://sua-loja.com/pedido/1024/obrigado",
    "tags": ["loja-online", "pedido-1024"]
  }'

Pix e cartão

Para aceitar cartão, inclua credit_card em methods e defina maxInstallments. O pagador informa os dados sensíveis no checkout hospedado da Sinnu.

Link com cartão até 12x
curl -X POST https://api.sinnu.com.br/api/payment-links \
  -H "Authorization: Bearer <SUA_CHAVE_DE_API>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Curso de TypeScript",
    "description": "Acesso anual",
    "priceMode": "fixed",
    "amountCents": 9900,
    "methods": ["pix", "credit_card"],
    "maxInstallments": 12,
    "interestMode": "pass_to_customer",
    "status": "active",
    "threeDsMode": "always"
  }'

Resposta

Resposta 201
{
  "id": "0f5b3d0f-5b44-4f66-92c9-1e7d7c0f1234",
  "slug": "abcd1234",
  "title": "Curso de TypeScript",
  "description": "Acesso anual",
  "priceMode": "fixed",
  "amountCents": 9900,
  "methods": ["pix", "credit_card"],
  "maxInstallments": 12,
  "interestMode": "pass_to_customer",
  "status": "active",
  "threeDsMode": "always",
  "tags": [],
  "redirectUrl": null,
  "linkedCustomerId": null,
  "createdAt": "2026-06-12T12:00:00.000Z",
  "updatedAt": "2026-06-12T12:00:00.000Z"
}