Eventos de pedido - 4SeletPay

Os eventos de pedido são enviados para pedidos criados por POST /v2/orders. O data é o mesmo objeto devolvido por GET /v2/orders/{id}.

Evento	Quando acontece
`order.paid`	Todos os pagamentos do pedido foram confirmados
`order.failed`	O pedido falhou ou foi encerrado sem venda. O motivo vem em `data.failure_reason`
`order.refunded`	O pedido foi estornado
`order.chargeback`	O pedido recebeu chargeback

`order.paid`

{
  "id": "hook_Xy7kP2mQ9rT4vB1n",
  "type": "order.paid",
  "webhook_version": "v2",
  "created_at": "2026-09-14T15:04:05Z",
  "data": {
    "id": "ord_7Hk2Pq9Xm4Ln8Rt3",
    "object": "order",
    "status": "paid",
    "currency": "brl",
    "amount": 15000,
    "original_amount": 15000,
    "original_currency": "brl",
    "payments": [
      {
        "id": "cha_8Kq2Lm9XvB3nT7pZ",
        "object": "payment_intent",
        "status": "paid",
        "amount": 10000,
        "amount_refunded": 0,
        "currency": "brl",
        "original_amount": 10000,
        "original_currency": "brl",
        "exchange_rate": null,
        "payment_method_details": {
          "type": "card",
          "card": { "brand": "visa", "first_six": "411111", "last_four": "1111", "holder_name": "João Silva", "exp_month": 12, "exp_year": 2030 }
        }
      },
      {
        "id": "cha_3Hd7Wq1Ns5Rk9Yb2",
        "object": "payment_intent",
        "status": "paid",
        "amount": 5000,
        "amount_refunded": 0,
        "currency": "brl",
        "original_amount": 5000,
        "original_currency": "brl",
        "exchange_rate": null,
        "payment_method_details": {
          "type": "pix",
          "pix": {
            "qr_code": "00020126580014br.gov.bcb.pix...",
            "qr_code_url": "https://...",
            "expires_at": "2026-09-14 16:00:00"
          }
        }
      }
    ],
    "next_action": null
  }
}

`order.failed`

{
  "id": "hook_Pq4Rs8Tu2Vw6Xy0z",
  "type": "order.failed",
  "webhook_version": "v2",
  "created_at": "2026-09-14T15:04:05Z",
  "data": {
    "id": "ord_7Hk2Pq9Xm4Ln8Rt3",
    "object": "order",
    "status": "failed",
    "currency": "brl",
    "amount": 10000,
    "original_amount": 10000,
    "original_currency": "brl",
    "payments": [
      {
        "id": "cha_8Kq2Lm9XvB3nT7pZ",
        "object": "payment_intent",
        "status": "failed",
        "amount": 10000,
        "amount_refunded": 0,
        "currency": "brl",
        "original_amount": 10000,
        "original_currency": "brl",
        "exchange_rate": null,
        "payment_method_details": { "type": "card" }
      }
    ],
    "next_action": null,
    "failure_reason": {
      "code": "card_declined",
      "message": "O cartão foi recusado pelo emissor.",
      "customer_message": "Não foi possível concluir o pagamento. Revise os dados informados ou tente outro meio de pagamento.",
      "merchant_message": "O pagamento não foi concluído. Oriente o comprador a revisar os dados informados ou tentar outro meio de pagamento."
    }
  }
}

Mostre ao pagador apenas o customer_message. O message é técnico. Veja Pagamento recusado.

PIX expirado encerra o pedido. Em um pedido com vários pagamentos, se o PIX expira sem ser pago, o pedido é encerrado e a autorização do cartão é desfeita. O evento que chega é order.failed, e não um evento de cancelamento: a v2 não tem order.canceled. Em GET /v2/orders/{id} esse pedido aparece como canceled. A diferença entre o status e o evento é proposital — nos dois casos a venda não se concretizou.

Status do pedido

`status`	Significado
`processing`	Em processamento
`requires_capture`	Autorizado, aguardando captura
`requires_action`	Aguardando ação do cliente (pagar o PIX ou confirmar o código)
`paid`	Pago
`failed`	Falhou
`canceled`	Cancelado
`refunded`	Estornado
`partially_refunded`	Estornado parcialmente
`chargeback`	Chargeback

Um chargeback gera order.chargeback e também charge.chargeback para a cobrança afetada.

​order.paid

​order.failed

​Status do pedido

`order.paid`

`order.failed`

Status do pedido