Partner API
  1. Integration
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 Information
      • 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 Information
    • 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 Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
        • SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Integration

Webhooks

Real-time event notifications for seamless integration
Receive instant notifications about key events within the P100 system. Webhooks let you automate processes and react immediately to critical changes.

Supported Events#

Our webhooks cover a wide range of events across different modules. Click any event to view its documentation and payload.

User & KYC Webhooks#

User Balance Generation
Notifies you when a user's fiat balances become active after KYC completion.
KYC File Added
Provides real-time feedback on the outcome of a user's KYC document upload.
POA Verification Status
Get updates on the Proof of Address (POA) verification lifecycle.
KYC Verification Status
Receive detailed, real-time updates on the overall KYC verification process.
Create Wallet
Dispatched when a new blockchain wallet is successfully created for a user.

Transfers & Payments Webhooks#

P2P Transfer
Triggered when the status of a transfer (partner ↔ user) changes.
SEPA Transfer
Notifies you whenever the status of a SEPA transfer is updated.
SEPA Deposit
Dispatched when a new SEPA deposit is successfully credited to a user's account.
Crypto Withdrawal
Provides real-time notifications on the progress of a crypto withdrawal.
Crypto Deposit
Get updates for the entire lifecycle of an incoming crypto deposit.
Exchange
Triggered when the status of a currency exchange is updated.
Card Transaction
Dispatched in real-time for every successful transaction made with a user's card.
Order Status
Sends order lifecycle updates (e.g., wallet address ready).
Payment Link
Notifies you whenever the status of a payment link changes.

Card Webhooks#

Card 3DS Code
Delivers the one-time code for 3-D Secure (3DS) authentication.
Card Activation Code
Delivers the one-time code to complete adding a card to a digital wallet.

🛡️ Security & Verification#

⚠️ Critical Security Notice
Before processing any webhook notification, you must verify its authenticity. This is essential for a secure and reliable integration.

Authentication Token Verification#

Every webhook request from P100 includes a shared secret token in the HTTP headers.
Implementation Steps:
1.
Extract the token
2.
Verify against your secret
3.
Reject invalid requests
Reject requests with missing or invalid tokens.
Consider validating timestamps/nonces to mitigate replay attacks.

Getting Your Secret Token#

Your webhook secret is provided alongside your API key during integration setup. Store it securely and never expose it in client-side code.

Delivery & Retry Policy#

Acknowledging receipt
Return a 2xx HTTP status code to confirm successful processing.
Automatic retry mechanism
If delivery fails, up to 4 additional attempts are made with increasing delays.
AttemptDelay After Previous FailureStatus
1st–Initial delivery
2nd~8 secondsFirst retry
3rd~16 secondsSecond retry
4th~32 secondsThird retry
5th~64 secondsFinal retry
Retry behavior
Failure condition: Non-2xx responses or timeouts trigger retries.
Exponential backoff: Delay increases between attempts.
Timeout: Each request times out after 10 seconds.
Final state: After 5 failed attempts total, the webhook is marked as permanently failed.

🔧 Troubleshooting#

Common issues
ProblemCauseSolution
401 UnauthorizedInvalid tokenVerify your secret token
TimeoutsSlow processingReturn 200 immediately; process async

Need Help?#

📖 FAQ
Find answers to common questions about our API.
💬 Support
Can't find what you're looking for? Contact our support team.
Previous
Rate Limiting
Next
User Balance Generation Webhook
Built with