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

P2P Transfer Webhook

Webhook
POST
/transfer-webhook
This event is triggered whenever the status of a transfer changes, providing a real-time notification about the final outcome of the transaction. This webhook is essential for updating user balances, transaction histories, and for providing users with immediate feedback, especially in the case of a failed transfer where a reason is provided in the error object.

Status Descriptions:#

SUCCESSFUL: The transfer was completed successfully.
FAILED: The transfer failed. The error object in the payload will contain details about the cause of the failure.
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "20995085-dd1f-4425-988c-9104301997f6",
  "sourceExternalUserId": "a9bf6bc8-782d-4f5b-8b3e-7e46607e5ef3",
  "destinationExternalUserId": null,
  "amount": "0.10",
  "currency": "eur",
  "status": "SUCCESSFUL",
  "createdAt": "2025-07-03T13:56:47.194Z"
}'
Response Response Example
{}

Request

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Previous
KYC Verification Status
Next
SEPA Transfer
Built with