Payments
A payment represents a completed on-chain transfer of stablecoins from a customer. Payments are created when a customer completes a checkout or when a subscription renewal is processed.
Payment Modes
When creating a checkout or subscription, you can specify a payment_mode:
| Mode | Description |
|---|---|
direct | Funds are sent directly to your settlement wallet. This is the default. Refunds are initiated via the dashboard and completed by the merchant. |
two_step | Funds are held until you capture them to your settlement wallet or refund them to the customer using signed requests. |
Two-step mode requires a signing key. See Signed Requests for setup instructions.
Two-Step Payment Flow
- Customer pays — funds are held securely until you decide what to do with them
- Capture — you send a signed capture request to move funds to your settlement wallet
- Refund (if needed) — you send a signed refund request to return funds to the customer’s original wallet address
The API verifies your signature before executing any fund movement.
Refunds
How refunds work depends on the payment mode:
-
Direct mode — you initiate a refund via the Exodus Business dashboard, which records the refund and provides the customer’s wallet address. You then send the stablecoins from your settlement wallet to complete the refund.
-
Two-step mode — refunds are fully automated. You send a signed refund request via the API, and funds are returned to the customer’s original wallet address automatically.
Need partial captures or partial refunds? Contact your account manager to discuss options for partial fund movements.
Payment Statuses
| Status | Description |
|---|---|
authorized | Payment received, awaiting capture (two-step only) |
captured | Funds transferred to your settlement wallet |
refunded | Full amount refunded to customer |
succeeded | Payment completed (direct mode) |
failed | Payment attempt failed |
Available Endpoints
- Get Payment — Retrieve payment details
- List Payments — List all payments
- Capture Payment — Capture an authorized payment (two-step)
- Refund Payment — Refund a payment (two-step)
