{
  "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 expired

An active collection (QR or hosted checkout) reached a final state without receiving the payment: the payin moves from pending to expired (or failed). No funds move; create a new payin to retry the charge.

Every delivery includes X-Webhook-Event, X-Webhook-Event-ID, X-Webhook-Delivery-ID, X-Webhook-Timestamp and X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body)). Respond 2xx; up to 5 attempts with incremental backoff.

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"
}

Authorizations

Authorization

string

header

required

Session JWT (from register/login) or API key (pk_...). X-API-Key: <token> is accepted as an alternative header.

Body

application/json

payin_id

string

account_id

string

status

enum<string>

Available options:

expired,

failed

country

string

currency

string

local_amount

string

reference

string

idempotency_key

string

Response

200

Return any 2xx to acknowledge the delivery.