userMerchantVerification

Revoke a user's verification with a specific merchant. After revocation, the user must reauthenticate and complete MFA before accessing their user details or transacting with that merchant again. Identify the user by their AeroPass userId (UUID). The specified merchantId must be within the authenticated token's merchant scope, and the user must have an existing association with that merchant.

Revocation preserves the user's Aeropay account, linked bank connections, transaction history, and verification with other merchants.

To restore access, call POST /v2/user again to initiate authentication, then complete MFA through POST /v2/confirmUser. Once confirmed, GET /v2/user becomes available again. A previously stored userId does not bypass this requirement: GET /v2/user will not return the user's details for that merchant until verification is restored.

Error Glossary (click to expand)
CodeHTTP StatusMessage
AP009400Unauthorized
AP101404No authenticated user / user not associated with merchant
AP700400Missing or invalid required parameter
AP701400Improperly formatted parameter
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

AeroPass UUID of the user to unverify.

integer
required

Merchant identifier the user is associated with.

Headers
string
required

A merchant scoped token.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json