API Reference

Descrever a requisição que fazemos para os webhooks fornecidos e em quais situações a chamada ocorre

Comunicamos via webhook quando o pedido muda para os status AUTHORIZED, CANCELED e EXPIRED.

AUTHORIZED: O pedido está autorizado para ser criado o pagamento pelo varejista.

CANCELED: O pedido foi cancelado pelo consumidor.

EXPIRED: O pedido foi expirado.

Formato e requisição

O webhook será chamado via uma requição REST utilizando o método POST para a URL no campo webhook_url informada na criação do pedido, com o seguinte corpo:

{
  "id": "aae11abd-1f51-4854-b58b-473f83b2319f",
  "amount": 20000,
  "metadata": {
    "anyData": "XPTO"
  },
  "orderReference": "23423hshd3",
  "reference": "ASLKDFH28RY2E28938EHFEWJKF",
  "state": "AUTHORIZED",
  "type": "split"
}

Descrição dos campos

Nome do campoTipoDescrição
idstringID do checkout gerado pela api Pagaleve /checkouts.
amountnumberValor do pedido em centavos, passado na criação do checkout em order.amount
metadataobjectObjeto metadata fornecido no momento de criação do pedido
orderReferencestringID do pedido utilizado pelo lojista, passado no campo order.reference na criação do checkout
referencestringID do pedido utilizado na plataforma que o lojista utiliza para vendas
stateenumStatus do pedido:

AUTHORIZED - Autorizado, Cliente confirmou o pagamento da primeira parcela
RELEASED - Liberado, retornado quando foi feito o release do pedido caso o pagamento tenha sido criado como do tipo autorização.
CANCELED - Cancelado, para pedidos cancelados por ação do usuário.
EXPIRED - Expirado, para pedidos expirados.
typeenumTipo de pagamento utilizado.

split - Parcelado
upfront - À vista
declined - Declinado