Partner API
  1. Integration
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
        • KYC File Added
        • POA Verification Status
        • KYC Verification Status
      • 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. Integration

Webhooks

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

Supported Events#

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

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.

Transfers & Payments Webhooks#

P2P Transfer
Triggered when the status of a P2P transfer 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.

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 building a secure and reliable integration.

Authentication Token Verification#

Every webhook request from P100 includes a unique authentication token in the HTTP headers.
Implementation Steps:
1.
Extract the Token
2.
Verify Against Your Secret
3.
Reject Invalid Requests
Always reject requests with missing or invalid tokens
Consider implementing timestamp validation to prevent replay attacks

Getting Your Secret Token#

Your authentication token will be provided along with your API key during the integration setup process. Store it securely and never expose it in client-side code.

Delivery & Retry Policy#

Acknowledging Receipt
To confirm successful webhook processing, your endpoint must respond with a 2xx HTTP status code.
Automatic Retry Mechanism
If a delivery fails, we will make up to 4 additional attempts 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:
Delivery Failure: Non-2xx responses or connection timeouts trigger retries
Exponential Backoff: Delays increase between attempts
Timeout: Each request times out after 10 seconds
Final State: After 5 failed attempts in total, the webhook is marked as permanently failed

🔧 Troubleshooting#

Common Issues
ProblemCauseSolution
401 UnauthorizedInvalid signature✅ Verify your secret token
TimeoutsSlow processing✅ Return 200 immediately, process async

Need Help?#

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