Webhooks

Conceito Básico

Gatilhos (ou Webhooks) são endereços (URLs) para onde a BcPag dispara avisos (Via método POST) para certos eventos que ocorrem em sua conta.

As chamadas são enviadas com content-type application/json

Os gatilhos podem ser cadastrados pelo painel da Pay Tools em Webhooks.

Tipo	Descrição
transaction.created	Ocorre sempre que um transação é criada.
transaction.status_changed	Ocorre quando o status da transação é alterado.
link.created	Ocorre sempre que um Link é criado.
link.changed	Ocorre quando um Link é alterado.
link.paid	Ocorre quando um Link é pago.
customer.created	Ocorre sempre que um Cliente é criado.
customer.changed	Ocorre quando um Cliente é alterado.

O objeto de envio dos webhooks consiste num padrão de evento, onde o payload é alterado de acordo com o seu contexto.

{
   "event":"transaction.status_changed",
   "model":"transactions",
   "model_id":"123097",
   "payload":{…}
}

Transactions

Links

Customer

Objeto do contexto de transações.