Skip to navigation
API BaaSPeople

Invalidate a person's transaction PIN

Does not delete the row. Sets a hard lock (423 pin_locked on cashout) and keeps the person enrolled, so POST /v1/people/pin/reset-request still works. Does not ask for the current PIN. Hosted reset does not block this call.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
X-Acting-DocumentstringRequired
CPF of the person, 11 digits.
Idempotency-KeystringOptional

Optional client-generated idempotency token (recommended for safe retries).

Response

PIN invalidated.
documentstringOptional
statusstringOptional

Errors

404
Not Found Error