Preloader
Desenvolvedor

Gerar transação PIX

Cria uma transação de cash-in PIX e retorna QR Code e código copia-e-cola.

Endpoint: POST /api/transactions/create
Autenticação
  • Esta rota usa headers ci e cs.
  • Para projetos baseados em JWT, existe também o fluxo /api/payments/deposit.
Parâmetro Tipo Descrição
amount *numberValor em reais. Ex: 10.50
payerName *stringNome do pagador.
payerDocument *stringDocumento sem máscara.
transactionId *stringID único no seu sistema.
projectWebhook *stringURL para receber atualização de status.
descriptionstringDescrição da cobrança.
payerEmailstringOpcional. Caso não enviado, a PulsePag pode gerar um e-mail técnico interno.
splitUserstringEmail para split (quando aplicável).
splitTaxnumberPercentual do split.
gatewaystringRoteamento opcional por gateway.
curl -X POST 'https://api.pulsepag.com/api/transactions/create' \
  --header 'ci: seu_client_id' \
  --header 'cs: seu_client_secret' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 5,
    "payerName": "Nome do cliente",
    "payerDocument": "12345678909",
    "transactionId": "pedido-123",
    "description": "Pagamento pedido 123",
    "projectWebhook": "https://seusistema.com/webhooks/pix"
  }'
{
  "message": "Deposit created successfully.",
  "qrCodeResponse": {
    "transactionId": "pedido-123",
    "status": "PENDING",
    "qrcode": "000201010212...",
    "amount": 5
  }
}