PURCHASE_EXPIRED

Corresponde ao evento interno order.expired. O comprador gerou um PIX ou boleto mas não pagou dentro do prazo.

Quando é disparado

QR Code PIX expirou sem pagamento: o pedido vira expired até 1 hora após o vencimento do QR (folga para liquidação tardia), ou na hora se o gateway já encerrou a cobrança.
Boleto bancário venceu sem compensação: 3 dias após o vencimento (prazo de compensação), ou na hora se o gateway já encerrou a cobrança.
Uma vez por pedido. A verificação roda a cada 10 minutos.
Só PIX e boleto. Cartão recusado gera PURCHASE_PAYMENT_DECLINED; cartão + PIX com PIX vencido tem tratamento próprio (estorno do cartão) e não gera este evento.

O status expired é reversível: se o comprador voltar ao mesmo link e gerar um novo PIX ou boleto, o pedido reabre e, ao pagar, você recebe PURCHASE_APPROVED com a mesma purchase.transaction. Um pagamento tardio do PIX antigo também é aceito e gera PURCHASE_APPROVED.

Payload

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "order_id": 123,
  "creation_date": 1736611200000,
  "event": "PURCHASE_EXPIRED",
  "version": "2.0.0",
  "source": "velan",
  "data": {
    "purchase": {
      "transaction": "abc123-uuid-do-pedido",
      "status": "EXPIRED",
      "order_date": 1736524700000,
      "approved_date": null,
      "refund_date": null,
      "full_price": {
        "value": 297.00,
        "currency_value": "BRL"
      },
      "price": {
        "value": 197.00,
        "currency_value": "BRL"
      },
      "payment": {
        "type": "PIX",
        "installments_number": 1
      },
      "fees": {
        "value": 0.0,
        "currency_value": "BRL"
      },
      "net_amount": {
        "value": null,
        "currency_value": "BRL"
      },
      "gateway_transaction_id": null,
      "offer": {
        "code": "abc12345",
        "name": "Oferta Principal"
      },
      "order_bump": {
        "is_order_bump": false,
        "parent_purchase_transaction": null
      },
      "tracking": {
        "source": "google",
        "utm_source": "google",
        "utm_medium": "cpc",
        "utm_campaign": "black-friday",
        "utm_content": null,
        "utm_term": null,
        "src": null,
        "sck": null
      }
    },
    "product": {
      "id": 1,
      "name": "Curso de Marketing Digital",
      "external_id": "CRM-1234"
    },
    "buyer": {
      "name": "João Silva",
      "first_name": "João",
      "last_name": "Silva",
      "email": "joao@exemplo.com",
      "checkout_phone": "+5511999990000",
      "document": "123.456.789-00",
      "document_type": "CPF"
    },
    "order_bumps": []
  }
}

Campos-chave

Campo	Valor neste evento
`purchase.status`	`EXPIRED`
`purchase.approved_date`	`null` — pagamento nunca confirmado
`purchase.refund_date`	`null`
`purchase.payment.type`	Geralmente `PIX` ou `BILLET`

Integrações

Área de membros

Quando é disparado

Payload

Campos-chave

​Quando é disparado

​Payload

​Campos-chave

Quando é disparado

Payload

Campos-chave