{
  "payin_id": "567d0d1a-49bc-437e-92e3-77e921112e49",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "status": "expired",
  "country": "BO",
  "currency": "BOB",
  "local_amount": "60.99",
  "reference": "CBK7Q2M4XZ9P",
  "idempotency_key": "order-10042"
}

Payin expirado

Un cobro activo (QR o checkout hosteado) llegó a estado final sin recibir el pago: el payin pasa de pending a expired (o failed). No se mueve dinero; crea un payin nuevo para reintentar el cobro.

Cada entrega incluye X-Webhook-Event, X-Webhook-Event-ID, X-Webhook-Delivery-ID, X-Webhook-Timestamp y X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body)). Responde 2xx; hasta 5 intentos con backoff incremental.

WEBHOOK

payin_expired

{
  "payin_id": "567d0d1a-49bc-437e-92e3-77e921112e49",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "status": "expired",
  "country": "BO",
  "currency": "BOB",
  "local_amount": "60.99",
  "reference": "CBK7Q2M4XZ9P",
  "idempotency_key": "order-10042"
}

Autorizaciones

Authorization

string

header

requerido

JWT de sesión (de register/login) o llave de API (pk_...). X-API-Key: <token> se acepta como header alternativo.

Cuerpo

application/json

payin_id

string

account_id

string

status

enum<string>

Opciones disponibles:

expired,

failed

country

string

currency

string

local_amount

string

reference

string

idempotency_key

string

Respuesta

200

Devuelve cualquier 2xx para confirmar la entrega.