Skip to main content

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 a bank_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 a bank_account_id from creating a fiat account:

How It Works

Ad-hoc Redemptions

  1. Call the API: Create an orchestration specifying source stablecoin and destination bank account
  2. Validation: Paxos validates the request, available balance, and bank account status
  3. Conversion: Stablecoins are converted to USD
  4. Withdrawal: USD is sent to the specified bank account via wire transfer
  5. Monitor Status: Track your orchestration progress using webhooks or API polling

Rule-based Redemptions

  1. Create the Rule: Set up an orchestration rule for automatic redemption
  2. Get Deposit Address: Use the address returned in the rule’s source.crypto.address field
  3. Receive Deposit: External USDG arrives at your Paxos crypto address
  4. Automatic Trigger: The rule detects the deposit and initiates redemption
  5. Conversion: USDG is converted to USD
  6. Withdrawal: USD is sent to the specified bank account
  7. Monitor Status: Track your orchestration progress using webhooks or API polling

Prerequisites

Next Steps

I