Webhooks
É possível cadastrar gatilhos para receber as atualizações quando alguns eventos ocorrem nas transações. Os gatilhos são divididos em payin (Recebimentos) e payout (Pagamentos)
As mensagens são formatadas em json. A ordem dos campos pode ser modificada.
Como cadastrar webhooks
- Acesse o aplicativo Betpay no console ou diretamente no aplicativo
- No menu clique em “Configurações”
- Na seção “Webhooks” clique em “Adicionar webhooks”
- Preencha o tipo de webhook (payin/payout)
- Preencha a autenticação (campo opcional, o valor deste campo será preenchido no header “Authorization” da requisição)
- Preencha a url de recebimento do webhook (Url que será feita a requisição)
- Clique em “Salvar”
Recebimentos (Payin)
Os gatilhos de recebimento são enviados quando os seguintes eventos ocorrem: * Recebimento criado (status: pending) * Recebimento pago (status: paid) * Falha no reembolso (status: paid) * Recebimento reembolsado (status: refunded)
Corpo da mensagem:
json
{
"id": "16d8Tj4tFnLN6jySecOQBE",
"amount": 10,
"payer_name": "John Doe",
"payer_fiscal": "123456789",
"status": "pending",
"created_at": "1970-01-01T00:00:00.000Z",
"updated_at": "1970-01-01T00:00:00.000Z",
"end_to_end_id": "E60701190202502271705DY5AAAAAAA",
"webhook_status_code": 200,
"refund_end_to_end_id": "D15111975202502210712320466AAAAA",
"refund_at": "1970-01-01T00:00:00.000Z",
"paid_at": "1970-01-01T00:00:00.000Z",
"canceled_at": "1970-01-01T00:00:00.000Z",
"read_at": "1970-01-01T00:00:00.000Z",
"external_id": "IN1234"
}
O corpo da mensagem do webhook é o mesmo da resposta das consultas
Pagamentos (Payout)
Os gatilhos de pagamento são enviados quando os seguintes eventos ocorrem: * Iniciando processamento do pagamento (status: processing) * Pagamento concluido com sucesso (status: done) * Pagamento rejeitado (status: rejected)
Corpo da mensagem:
json
{
"id": "16d8Tj4tFnLN6jySecOQBE",
"external_id": "OUT1234",
"amount": 10,
"status": "processing",
"key_type": "cpf",
"key": "123456789",
"end_to_end_id": "E60701190202502271705DY5AAAAAAA",
"reject_reason": "123456789",
"created_at": "1970-01-01T00:00:00.000Z",
"updated_at": "1970-01-01T00:00:00.000Z",
"webhook_status_code": 200,
"validate_receiver": "123456789"
}
O corpo da mensagem do webhook é o mesmo da resposta das consultas