Partner API
  1. API References
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. API References

Partner Operations

This module contains endpoints for displaying information and managing the partner account, including generating deposit addresses, retrieving balances, transaction history, performing exchanges, SEPA transfers, crypto withdrawals, and internal transfers between the partner account and a user. These requests operate on the partner's account as a whole, in contrast to user-specific endpoints, and therefore do not require an external user ID — except for internal transfers, where the sourceExternalUserId or destinationExternalUserId must be provided to identify the user involved.
The Partner API is designed for business-level operations, such as treasury management, settlements, payouts, and controlled fund movements between the partner and their users.

Core endpoints#

Get Balances
View current balances for all supported currencies in your account.
Create Wallet
Generate a unique deposit address for a specific cryptocurrency (and network, if applicable).
Get Transaction History
Retrieve a detailed, paginated history of all account transactions.
Create Exchange Lock
Get a live exchange rate and lock it for a future transaction.
Finalize Exchange
Execute a currency exchange using a previously created rate lock.
Create Crypto Withdrawal
Initiate a cryptocurrency withdrawal to a specified external wallet.
Get Crypto Withdrawal Details
Check the status and blockchain details of a crypto withdrawal.
Create a SEPA Transfer
Send funds from your fiat balance to an external bank account via SEPA.
Get SEPA Transfer Details
Check the status and details of a specific SEPA transfer.
Create a Transfer
Initiate a partner↔user internal transfer (partner balance is always involved).
Get Transfer Details
Track the final status and details of a specific internal transfer.

Typical Workflows#

Workflow: Receiving Cryptocurrency
1.
Generate a new wallet for the desired currency using Create Wallet.
2.
After the wallet is successfully created, you will receive a Create Wallet Webhook notification confirming wallet creation and providing the deposit address.
3.
Provide this wallet address to the sender to receive funds into your partner account.
Workflow: Currency Exchange
1.
Retrieve exchange rates and create a rate lock for the partner account using Retrieve Exchange Rate and Create a Lock.
2.
Finalize the exchange using the lockId from the previous step with Create and Finalize an Exchange.
3.
Track the transaction status using either:
Retrieve Detailed Exchange Information with the exchangeId received in the response, or
Exchange Webhook to receive automatic status updates.
Workflow: Crypto Withdrawal
1.
(Recommended) Check the network fee for the selected currency using Get Network Fee.
2.
Create a crypto withdrawal from the partner balance using Create Crypto Withdrawal.
3.
Track the transaction status using either:
Get Crypto Withdrawal Details with the withdrawalId received in the response, or
Crypto Withdrawal Webhook to receive automatic status updates.
Workflow: SEPA Transfer
1.
Create a SEPA transfer from the partner balance using Create a SEPA Transfer.
2.
Track the transaction status using either:
Get SEPA Transfer Details with the transferId received in the response, or
SEPA Transfer Webhook for asynchronous notifications.
Workflow: Internal Transfer (Partner ↔ User)
1.
Initiate using Create a Transfer.
Provide destinationExternalUserId → funds move from partner to user.
Provide sourceExternalUserId → funds move from user to partner.
Direct user-to-user transfers are not supported.
2.
Track the transfer using either:
Get Transfer Details with the transferId, or
P2P Transfer Webhook for real-time updates and error reporting.
3.
See full request/response schema in the Internal Transfers.
Previous
API References
Next
Get Balances
Built with