Pular para o conteúdo principal

Primeiros passos

1. Crie uma chave de API​

No painel da SeventyOne Pay, abra Integração → Chaves de API e crie uma chave para a integração. Se você tem mais de uma conta de processamento, escolha se a chave segue a conta ativa ou fica presa a uma conta. Escolha apenas as permissões que ela realmente precisa (por exemplo, payments:create e payments:read para uma loja que só cobra e consulta).

Guarde a chave com cuidado

O valor completo da chave aparece uma única vez, no momento da criação. Depois disso o painel mostra só os últimos caracteres. Nunca coloque a chave em código de navegador, aplicativo móvel distribuído ou repositório público: chame a API sempre a partir do seu servidor.

2. Teste a conexão​

curl https://seventyonepay.online/api/v1/health
{ "success": true, "data": { "status": "ok", "version": "v1", "time": "2026-01-01T12:00:00.000Z" } }

Em seguida confirme que sua chave funciona:

curl https://seventyonepay.online/api/v1/me \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

A resposta mostra a chave em uso e o lojista vinculado a ela.

3. Crie uma cobrança PIX​

curl -X POST https://seventyonepay.online/api/v1/pix \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1001" \
  -d '{
    "amount": 1990,
    "description": "Pedido 1001",
    "external_id": "1001",
    "customer": {
      "name": "Maria Souza",
      "email": "maria@exemplo.com",
      "phone": "11999998888",
      "document_type": "CPF",
      "document_value": "12345678909"
    }
  }'

A resposta traz o copy_paste_code (PIX copia e cola) e o qr_code para você exibir ao cliente. Veja todos os campos em Cobranças PIX.

4. Seja avisado quando o cliente pagar​

Em vez de ficar consultando a API, cadastre um endereço HTTPS no painel (Integração → Webhooks) e assine o evento pix.paid (ou payment.approved). Nós chamamos o seu servidor assim que o pagamento é confirmado. Leia Webhooks e sempre verifique a assinatura.

Checklist antes de ir para produção​

  • A chave de API está em variável de ambiente no servidor, fora do repositório.
  • Toda criação de cobrança envia um Idempotency-Key estável (por exemplo, o id do pedido).
  • O endpoint de webhook usa HTTPS, valida a assinatura e responde 2xx rápido.
  • O processamento do webhook é idempotente (o mesmo evento pode chegar mais de uma vez).
  • Você trata 429 respeitando o header Retry-After.