API BaaSSecurity

Verify an operator's PIN

For confirming the PIN before building the payment form, so a typo does not surface at the end of the flow. A wrong attempt counts towards the lockout exactly like one on a payment — this is not a free oracle.

Authentication

AuthorizationBearer

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

Path parameters

accountIdstringRequired
Account identifier.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
Idempotency-KeystringOptional

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

Request

This endpoint expects an object.
actingDocumentstringRequired
pinstringRequired

Response

PIN is correct.
validbooleanOptional

Errors

403
Forbidden Error
423
Locked Error
429
Too Many Requests Error