card_payment.paid - PurinCash

Quando um pagamento no cartão é confirmado, a gente faz POST na callbackUrl daquela cobrança.

POST https://minhaloja.com/webhooks/purincash
Content-Type: application/json
X-Webhook-Signature: a3f5b8c2e1d4f7a9b6c8d2e5f1a4b7c9d2e5f8a1b4c7d0e3f6a9b2c5d8e1f4a7
X-Webhook-Id: card_payment.paid:JUE7Y9MPSX

{
  "event": "card_payment.paid",
  "orderCode": "JUE7Y9MPSX",
  "amount": 49.90,
  "status": "paid",
  "paidAt": "2026-03-18T12:05:00.000Z",
  "customer": { "name": "João Silva", "email": "joao@exemplo.com" },
  "metadata": "{\"pedido\":\"1042\"}"
}

As duas diferenças que importam

O identificador é orderCode, não paymentId.O valor vem em amount (reais, decimal), não em amountCents.

Se o seu handler é genérico, normalize na entrada em vez de espalhar if pelo código:

function normalizar(evento) {
  if (evento.event === "card_payment.paid") {
    return {
      id: evento.orderCode,
      valorCents: Math.round(evento.amount * 100),
      pagoEm: evento.paidAt,
      customer: evento.customer,
      metadata: evento.metadata,
    };
  }

  // payment.paid e charge.paid
  return {
    id: evento.paymentId,
    valorCents: evento.amountCents,
    pagoEm: evento.paidAt,
    customer: evento.customer,
    metadata: evento.metadata,
  };
}

Math.round(amount * 100) e não amount * 100. Ponto flutuante transforma 49.90 * 100 em 4989.999999999999, e o !== contra o valor esperado passa a falhar de forma aleatória.

Campos

string

required

Sempre card_payment.paid.

string

required

Código do pedido no cartão. É o mesmo usado em GET /v1/card-payments/{orderCode}.

number

required

Valor em reais, decimal.

string

required

Sempre paid neste evento.

string

required

Data e hora da confirmação, em ISO 8601.

object

name e email, quando informados na criação.

string

A string JSON enviada na criação. Vem null quando não houve.

Garantias

As mesmas do PIX: assinatura HMAC em X-Webhook-Signature, idempotência em X-Webhook-Id, timeout de 5 segundos e até 7 tentativas com backoff. Detalhes em Visão geral.

Cartão não tem webhook em sandbox, porque cartão não roda em sandbox. Para testar o handler, faça uma cobrança real de valor baixo em produção.

Lembrete sobre a successUrl

O cliente cair na sua successUrl não é confirmação de pagamento. É só o navegador voltando, e a URL pode ser aberta na mão por qualquer um. Libere o produto por este webhook ou por GET /v1/card-payments/{orderCode}.

​As duas diferenças que importam

​Campos

​Garantias

​Lembrete sobre a successUrl

As duas diferenças que importam

Campos

Garantias

Lembrete sobre a successUrl