Skip to main content

Direct Debit API

The Direct Debit API enables merchants to establish pre-authorization contracts with customers, allowing recurring or on-demand cryptocurrency charges without requiring user interaction for each payment.

How It Works

  1. Scenario Discovery - Retrieve supported scenario codes that define transaction types and limits
  2. Contract Creation - Generate a pre-authorization contract with QR code and deep link
  3. User Signing - Customer approves the contract via their payment provider app
  4. Status Verification - Query the provider to confirm the contract has been signed
  5. Payment Execution - Charge amounts against the signed contract
  6. Contract Management - Sync status, execute payments, or terminate as needed

Contract Lifecycle

Endpoints

Key Concepts

Scenario Codes

Provider-specific pre-authorization types that define maximum transaction limits. Each scenario has a unique ID and is associated with a payment provider (Binance Pay, Bybit Pay, KuCoin Pay).

Single Upper Limit

The maximum amount that can be charged in a single payment execution against the contract.

Fee Breakdown

Each executed payment includes a detailed fee breakdown with exchange fees and platform fees, showing gross amount, deductions, and net settlement amount.