Overview
Orchestrations enable you to convert stablecoins back to USD and withdraw to external bank accounts. These can be triggered through ad-hoc orchestrations from profiles or rule-based orchestrations from external crypto deposits.Redeem Flow Options
Creating Redemptions
Example 1: USDC → USD (Ad-hoc, Profile to Bank)
Use the Create Orchestration endpoint to convert USDC from your profile to USD and withdraw to a bank account. You’ll need abank_account_id
from creating a fiat account:
Example 2: USDG → USD (Rule-based, External to Bank)
Use the Create Orchestration Rule endpoint to automatically convert external USDG deposits to USD and withdraw to a bank account. You’ll need abank_account_id
from creating a fiat account:
How It Works
Ad-hoc Redemptions
- Call the API: Create an orchestration specifying source stablecoin and destination bank account
- Validation: Paxos validates the request, available balance, and bank account status
- Conversion: Stablecoins are converted to USD
- Withdrawal: USD is sent to the specified bank account via wire transfer
- Monitor Status: Track your orchestration progress using webhooks or API polling
Rule-based Redemptions
- Create the Rule: Set up an orchestration rule for automatic redemption
- Get Deposit Address: Use the address returned in the rule’s
source.crypto.address
field - Receive Deposit: External USDG arrives at your Paxos crypto address
- Automatic Trigger: The rule detects the deposit and initiates redemption
- Conversion: USDG is converted to USD
- Withdrawal: USD is sent to the specified bank account
- Monitor Status: Track your orchestration progress using webhooks or API polling
Prerequisites
- Bank Account: Must have an approved bank account added via Create Fiat Account
- Account Status: Verify account is
APPROVED
using Get Fiat Account
Next Steps
- Learn about minting stablecoins from USD deposits
- Explore conversions between different stablecoins