This page shows how to combine Partner API endpoints into complete business flows. Each use case describes the problem, the solution and the steps with the endpoints involved.
Use Case 1: Crypto Payouts to Suppliers and Partners#
Challenge#
You pay suppliers, contractors or partners who prefer to receive crypto. Sending payments manually is slow, error-prone and hard to track.Solution#
Register each recipient once on your whitelist, then send payouts with a single API call and track their status automatically.Steps#
1.
Register the recipient - add the recipient's wallet address with Add Whitelisted Wallet (POST /v1/partner/whitelisted-wallets). Store the returned id in your system. 2.
Send the payout - create a withdrawal with Create Crypto Withdrawal (POST /v1/partner/crypto-withdrawal), passing the recipient's walletId and the amount. Result#
Recipient details are provided once, every payout is a single request, and your system knows the status of each payment without manual checks.
Use Case 2: Cross-Border Payouts Funded in EUR#
Challenge#
Your business operates in EUR, but you need to pay recipients abroad in crypto. Buying crypto on a separate platform and transferring it manually takes time and creates operational risk.Solution#
Fund your account with EUR via SEPA, exchange it to crypto at a locked rate and send it to the recipient - all within one account.Steps#
1.
Fund your EUR balance - get the bank details with Get SEPA Payment Details (GET /v1/partner/sepa-payment-details) and send a SEPA transfer with the returned title. 2.
Lock the rates - call Create Lock (POST /v1/exchange/lock) and calculate the amount you will receive from the locked rates. 3.
Execute the exchange - call Create Exchange (POST /v1/partner/exchange) with the lockId, the EUR and destination balances and the amount. Result#
You keep your treasury in EUR and convert only what you need for each payout, at a rate you see before executing.
Use Case 3: Converting Crypto Income to EUR#
Challenge#
You receive part of your income in crypto, but your costs and accounting are in EUR. Holding crypto exposes you to price changes.Solution#
Convert incoming crypto to EUR as soon as it is credited and, if needed, withdraw it to your bank account.Steps#
1.
Receive crypto - get your deposit address for the currency from Get Balances (depositAddress) and share it with the payer. 4.
Withdraw to your bank - optionally send EUR to your bank account with Create SEPA Withdrawal (POST /v1/partner/sepa-withdrawal). Each crypto balance has one deposit address for the whole Partner account, not a separate address per payment. This flow is suitable for converting your own crypto income, but not for accepting payments from many customers where each payment must be matched to a specific order.
Result#
Crypto income is converted to EUR automatically, so your exposure to crypto price changes is limited to the time between the deposit and the exchange.
Use Case 4: Automated Treasury Rebalancing#
Challenge#
Your treasury holds several assets. Keeping their proportions within your risk limits requires constant monitoring and manual trades.Solution#
Build a script that checks your balances on a schedule and exchanges assets when they exceed your limits.Steps#
1.
Monitor - check balances and their EUR value with Get Balances. 2.
Lock - when an asset exceeds your limit, lock the rates with Create Lock. 3.
Execute - execute the exchange with Create Exchange before the lock expires. Example (Python)#
The script below converts the part of a DOGE balance that exceeds 500 EUR in value into EUR.The lock is valid for about 45 seconds. Execute the exchange right after creating the lock - if it expires, create a new one.
Result#
Your treasury stays within your risk limits without manual trading.
Next Steps#
Webhooks - receive transaction status updates. 