Partner API
  1. User & KYC Webhooks
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Get Balances
      • Get Transaction History
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Create Crypto Withdrawal
      • Create a SEPA Transfer
      • Get SEPA Transfer Details
    • User Accounts with KYC
      • Create User Account and Generate Balances
      • Add KYC File
      • Add POA File
      • Add User Verification
      • Update Existing User
      • Delete User
      • Suspend User
      • Unsuspend User
      • Get User Balances
      • Get User Transaction History
    • User Accounts without KYC
      • Create User Account and Generate Balances Without KYC
      • Update Existing User
      • Delete User
      • Suspend User
      • Unsuspend User
      • Get User Balances
      • Get User Transaction History
    • KYC by P100
      • Creating KYC Verification
      • Redirect to Verification
      • Get KYC Status
    • Currency Exchange
      • Retrieve Exchange Rate
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Retrieve Detailed Exchange Infromation
    • Crypto Deposits
      • Update Travel Rule
    • Crypto Withdrawals
      • Get Network Fee
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
    • Internal Transfers
      • Create a Transfer
      • Get Transfer Details
    • Virtual Cards
      • Create Virtual Card
      • Get All User Cards
      • Get Card Details
      • Update Card PIN
      • Block Card
      • Unblock Card
      • Get Card Limits
      • Update Card Limits
      • Delete Card
    • Custom Fiat Operations
      • SEPA Deposit & Withdrawal
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation
          POST
        • KYC File Added
          POST
        • POA Verification Status
          POST
        • KYC Verification Status
          POST
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
        • SEPA Transfer
        • SEPA Deposit
        • Crypto Withdrawal
        • Crypto Deposit
        • Exchange
        • Card Transaction
      • Card Webhooks
        • Card 3DS Code
        • Card Activation Code
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. User & KYC Webhooks

POA Verification Status

Webhook
POST
/webhook/poa-verification/status
This event is dispatched whenever the status of a user's Proof of Address (POA) verification changes. It provides real-time updates on the verification lifecycle, from initial submission to final approval or rejection. Use this webhook to automate user communication and internal workflows based on the outcome of the POA check.

Status Descriptions:#

WAITING: The initial status after a document has been submitted. It is now in the queue awaiting review by our team.
APPROVED: The document has been successfully reviewed and accepted. The POA verification for this user is complete.
REJECTED: The document has been reviewed and permanently rejected. This may be due to the document being invalid, expired, or fraudulent. The user will likely need to submit a different document.
QUESTIONED: The document has been reviewed, but an issue prevents its approval (e.g., the image is blurry, a corner is cut off, or information is illegible). The user needs to take corrective action, such as re-uploading a clearer image.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data-raw '{
  "externalUserId": "bca65c48-df49-4831-a7b2-de7903321581",
  "status": "APPROVED"
}'
Response Response Example
{}

Request

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Previous
KYC File Added
Next
KYC Verification Status
Built with