Enviar Pagamento via Pix

Este endpoint realiza o envio de um pagamento via Pix. Para utilizá-lo, deve ser efetuada uma chamada para a API conforme especificado abaixo:

Fazendo Requisição

A chamada deverá ser feita utilizando o método POST.

URL

https://api.gerapix.digital/v1/pix/payments/

Autenticação da Requisição

Para consumir este endpoint, é obrigatório incluir no cabeçalho da requisição HTTP um token de autenticação no formato.

Bearer

Este token é único por cliente e permite que a plataforma valide e autorize a requisição.

Na GeraPix, cada cliente possui dois tipos de token: público e secreto. Para esse endpoint, é obrigatório utilizar o token secreto.

Exemplo de Cabeçalho:

Authorization: Bearer SEU_TOKEN_AQUI
Content-Type: application/json
    

Nota: Substitua SEU_TOKEN_SECRETO pelo seu token secreto, disponível no painel administrativo da GeraPix.

Importante:

• O token é confidencial e não deve ser exposto publicamente.
• Requisições sem autenticação válida retornarão erro.
401 Unauthorized
• Caso seu token seja comprometido, revogue-o imediatamente e gere um novo no painel.

{
  "valor": "49.90",
  "nome": "João Silva",
  "doc_tipo": "cpf",
  "doc_numero": "12345678901",
  "callback_url": "https://seusite.com/callback",
  "external_reference": "pedido_12345"
}

{
  "id_transacao": "91000186601",
  "external_reference": "pedido_12345",
  "status": "Aprovado"
}

PIX IN / PIX OUT

Webhook de Atualização de Status Pix

A GeraPix utiliza este endpoint para enviar notificações automáticas (webhook) ao seu sistema sempre que houver uma atualização no status de uma transação Pix — seja uma cobrança recebida ou um envio de pagamento. A URL de notificação (callback_url) é definida no momento da criação da transação, tanto para cobranças quanto para envios.

Fazendo Requisição

A chamada deverá ser feita utilizando o método POST.

Autenticação da Requisição

Para garantir a segurança, é obrigatório validar o token de autenticação enviado no cabeçalho da requisição no formato:

Bearer

Esse token permite confirmar que a requisição foi realmente enviada pela plataforma GeraPix.

Na GeraPix, cada cliente possui dois tipos de token: público e secreto. Para validação do webhook, deve-se utilizar o token secreto.

Exemplo de Cabeçalho:

Authorization: Bearer SEU_TOKEN_SECRETO
Content-Type: application/json
  

Nota: Substitua SEU_TOKEN_SECRETO pelo token secreto disponível no painel administrativo da GeraPix.

Importante:

• O token é confidencial e não deve ser exposto publicamente.
• Requisições sem autenticação válida retornarão erro.
401 Unauthorized
• Caso seu token seja comprometido, revogue-o imediatamente e gere um novo no painel.

{
  "id_transacao": "91000186601",
  "status": "Aprovado",
  "external_reference": "pedido_12345"
}