1. Obtenha sua API key
Acesse o painel Sinnu em Chave de API e gere uma chave secreta. Toda chave pública de integração usa o prefixo sk_live_.... Trate a chave como uma senha: nunca a exponha no frontend.
2. Crie um link de pagamento
Todas as chamadas usam autenticação Bearer e a URL base de produção https://api.sinnu.com.br. O exemplo abaixo cria um link Pix de R$ 19,90. Valores de link são sempre em centavos.
POST /api/payment-links
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",
"priceMode": "fixed",
"amountCents": 1990,
"methods": ["pix"],
"maxInstallments": 1,
"interestMode": "absorb",
"threeDsMode": "always"
}'3. Compartilhe o checkout
A resposta traz o slug do link. Use esse slug para montar a URL pública do checkout hospedado.
Resposta 201
{
"id": "0f5b3d0f-5b44-4f66-92c9-1e7d7c0f1234",
"slug": "abcd1234",
"title": "Pedido #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"
}URL do checkout
https://pay.sinnu.com.br/abcd1234Valores em centavos
amountCents é sempre um inteiro em centavos. R$ 19,90 vira 1990; R$ 129,90 vira 12990.