Introduction - Fin Crypto Orchestration

​

Payment Sources

​

Use Cases

​

1. Prediction Market Deposits

• Opens the deposit flow on the platform
• Selects Bybit Pay, Kraken Pay, or pays from an external wallet
• Confirms the transaction

1. Platform calls the Quote Estimation API to get the conversion rate and fees for the deposit amount.
2. User confirms. Platform calls the Create Order API to initiate the transaction.
3. For exchange pay (Bybit/Kraken): user scans a QR code to authorize payment from their exchange account. For external wallets: user sends to a provided deposit address.
4. Fin receives the funds, deducts the platform fee, and credits the destination wallet.
5. Platform calls Get Payment Details API to confirm settlement and update the user’s balance.

• Pay with USDC → receive USDC on Solana, Base, or Ethereum
• Pay with USDC → receive USDC on Polygon
• Additional tokens and chains can be added based on platform requirements

​

2. Multi-Chain Wallet Top-Ups

• Initiates a deposit on the platform
• Chooses their preferred token and payment method
• Sends funds from any external wallet

1. Quote Estimation API returns the rate, fee, and expected delivery amount for the selected token pair.
2. Create Order API generates the deposit address or QR code.
3. User sends funds. Fin receives the deposit, handles any conversion, deducts the fee, and delivers to the destination wallet.
4. Get Payment Details API confirms the transaction status.

• Bitcoin on the Bitcoin network
• ETH on Ethereum
• USDT on Tron
• USDC on Solana, Base, Ethereum

​

3. Cross-Token Deposits

• Initiates a deposit
• Pays with USDT from Bybit Pay
• Receives PYUSD in their platform wallet

1. Quote Estimation API returns the USDT → PYUSD conversion rate and fees.
2. Create Order API initiates the order and generates the Bybit Pay QR code.
3. User scans the QR code. USDT is deducted from their Bybit Pay account.
4. Fin converts USDT to PYUSD, deducts the fee, and deposits PYUSD into the user’s platform wallet.
5. Get Payment Details API confirms delivery.

​

API Overview

​

Supported Assets

​

How Fees Work

​

Integration Flow for receiving payments

1. User initiates deposit on your platform
2. Your backend calls Quote Estimation API → show rate + fees to user
3. User confirms → your backend calls Create Order API
4. User pays (QR scan or wallet transfer)
5. Fin receives funds → deducts fee → delivers to destination wallet
6. Your backend polls Get Payment Details API → updates user balance

​

Flow of APIs for Crypto transfer to external wallets:

• Call the Get Customer Details API to get the wallet addresses assigned to the customer along with their balances.
• Fin provisions wallets for the following chains: Polygon, Ethereum, and Solana. (Save wallet IDs to use in quote later)
• You will receive crypto in these wallets from the external sources.

• Call the Create beneficiary V3 endpoint with the fields required for external crypto. (Save beneficiary ID to use in quote later)
• Follow the exact payload structure given in the request example.
• Monitor webhook for beneficiary approval (beneficiary.created, beneficiary.status). It’s almost instant.
• You can check beneficiary details using Fetch beneficiary details V2

• Webhook event to monitor: transaction.status
  • TransactionType: CRYPTO_DEPOSIT
  • Status: FUND_RECEIVED

• Call the Create quote with beneficiary_id and crypto_wallet_id .
• You will get a quote estimation and expiry time

• Call Execute quote with the quote_id from the former response

• Webhook event to monitor: transaction.status
  • TransactionType: CRYPTO_WITHDRAWAL
  • Status: FUND_REQUEST_SUCCESS