Webhooks

• O pagamento de um PIX for aprovado pelo banco.
• Um saque (Payout) finalizar com sucesso.
• Um pagamento por Cartão de Crédito virar Chargeback.

​

Onde configurar

​

Validação e Eventos (Payins)

{
  "id": "payin_12345",
  "status": "APPROVED",
  "paymentMethod": "PIX",
  "amount": 10000,
  "referenceId": "meu-pedido-1234",
  "customer": {
    "name": "Maria Silva",
    "email": "maria@email.com"
  },
  "updatedAt": "2026-03-02T12:00:00.000Z"
}

​

Possíveis Status do Payin

• PENDING - Gerado, aguardando liquidação.
• APPROVED - O saldo está disponível para a loja.
• FAILED - Falha catastrófica (Ex: Adquirente fora do ar).
• CANCELED - A transação foi cancelada antes de ocorrer.
• REFUSED - Saldo negado pelo emissor do Cartão ou sistema Anti-Fraudes.
• REFUNDED - Você aplicou um estorno parcial/total na mesma.
• CHARGEBACK - Seu cliente contestou com o banco emissor o uso indevido da compra.
• MED - Seu cliente contestou com o banco emissor o uso indevido da compra.
• EXPIRED - Janela de PIX ou Boleto vencidas.

​

Validação e Eventos (Payouts)

{
  "id": "payout_98765",
  "status": "APPROVED",
  "amount": 50000,
  "pixKey": "maria@email.com",
  "pixKeyType": "EMAIL",
  "referenceId": "saque-afiliado-01",
  "updatedAt": "2026-03-02T12:30:00.000Z"
}