Pular para o conteúdo
Alfasu Pay
Como integrar Pix com a API Alfasu Pay
Integrações

Como integrar Pix com a API Alfasu Pay

Time Alfasu Pay15 de março de 20255 min de leitura

O Pix se tornou o meio de pagamento preferido no Brasil. Com a API da Alfasu Pay, você pode gerar cobranças Pix dinâmicas em poucos minutos, sem precisar de certificado digital ou integração complexa com o Banco Central.

Pré-requisitos

Antes de começar, você precisa de:

  • Uma conta ativa na Alfasu Pay
  • Sua API Key de produção ou sandbox
  • Um endpoint HTTPS para receber webhooks (recomendado)

Dica

Use o ambiente sandbox para testar sua integração antes de ir para produção. Veja nossa documentação de sandbox.

Passo 1: Autenticação

Todas as requisições devem incluir o header Authorization com seu token Bearer:

curl -X GET https://api.alfasupay.com.br/v1/account \
  -H "Authorization: Bearer sk_live_sua_chave_aqui"

Passo 2: Criar uma cobrança Pix

Envie um POST para /v1/pix/charges com o valor e os dados do pagador:

{
  "amount": 15000,
  "description": "Pedido #1234",
  "payer": {
    "name": "Maria Silva",
    "document": "12345678900"
  }
}

A resposta incluirá o QR Code (copia e cola) e o status pending.

Passo 3: Receber confirmação via webhook

Configure um webhook para o evento pix.charge.paid. Quando o pagamento for confirmado, você receberá um POST com os dados da transação.

Importante

Sempre valide a assinatura do webhook antes de processar o pagamento no seu sistema.

Próximos passos