Skip to main content
DELETE
Revocar un token

Authorizations

Authorization
string
header
required

Llave cbx_live creada para el partner.

Headers

Cobrix-Timestamp
string
required

Segundos Unix dentro de una ventana de cinco minutos.

Pattern: ^[0-9]{10}$
Cobrix-Signature
string
required

HMAC-SHA256 de timestamp, método, ruta y cuerpo crudo.

Pattern: ^v1=[a-f0-9]{64}$

Path Parameters

companyId
string<uuid>
required

Empresa vinculada a la llave.

tokenId
string<uuid>
required

El id que respondió POST payment-verifications/tokens. Otro valor que no sea un UUID responde 400 invalid_request.

Response

El token después de revocarlo

id
string
required

El id del token. Es un UUID.

status
enum<string>
required

active: se puede usar. verified: se cerró con un pago verificado. pending_review: se cerró con un Zelle que espera revisión. rejected: se cerró con un Zelle que una persona de la empresa rechazó. exhausted: gastó sus intentos sin un pago verificado, o llegó a su tope de envíos. expired: caducó. revoked: lo revocaste, o la llave que lo emitió ya no sirve. Un token exhausted se lee expired cuando caduca y revoked si lo revocas.

Available options:
active,
verified,
pending_review,
rejected,
exhausted,
expired,
revoked
attemptsUsed
integer
required

Intentos gastados. Un intento devuelto porque el banco no respondió no cuenta. Puede ser menor que maxAttempts en un token exhausted: llegó a su tope de envíos.

maxAttempts
integer
required
expiresAt
string<date-time>
required
externalReference
string | null
required
verificationId
string | null
required

En un token cerrado con un resultado, la validación que lo cerró. Léela con GET payment-verifications/{verificationId}.

lastErrorCode
string | null
required

El resultado del último intento que no verificó, por ejemplo not_found, mismatch, ambiguous, already_used o unverifiable. rate_limited si lo frenó el límite de la llave. El detalle está en la validación.