Partner API
  1. User & KYC Webhooks
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Get Balances
      • Create Wallet
      • Get Transaction History
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Retrieve Detailed Exchange Infromation
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
      • Create a SEPA Transfer
      • Get SEPA Transfer Details
    • User Accounts
      • Create User Account
      • Add KYC File
      • Add POA File
      • Add User Verification
      • Extend user
      • 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
    • Orders
      • Get Rates
      • Retrieve Order Rate and Create a Lock
      • Create and Finalize an Order
      • Get Order Details
    • Payment link
      • Generate Payment Link
      • Get Payment Link Details
  • 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
        • Create wallet
          POST
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
        • SEPA Transfer
        • SEPA Deposit
        • Crypto Withdrawal
        • Crypto Deposit
        • Exchange
        • Card Transaction
        • Order status
        • Payment Link
      • 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

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

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
{}
Previous
KYC File Added
Next
KYC Verification Status
Built with