Skip to main content
POST
Revoke a verification

Authorizations

DPoP
string
header
required

Per-request DPoP proof JWT (RFC 9449). MUST accompany the Authorization: DPoP <access_token> header on every protected operation. The proof is signed by the merchant's private DPoP key and carries htm, htu, iat, jti, and ath claims.

Headers

Idempotency-Key
string
required

Unique key identifying this operation. Sending the same key twice returns the original response instead of creating a duplicate. Keys are retained for 24 hours.

Maximum string length: 255

Path Parameters

id
string
required

Verification attempt ID.

Pattern: ^vrf_[a-zA-Z0-9]+$

Response

Attempt revoked.

data
object
required

One verification attempt. hosted_link is secret-once: present only on the response that minted it (create / resend / regenerate / re-verify) and never on a read.