Skip to main content

Overview

The AliX Pay partner API pays fiat out to bank accounts and merchant QR codes on your instruction, settled against a crypto fund you hold with AliX. You integrate once; AliX handles the local payment rails, the exchange from crypto to fiat, and the compliance checks behind each payout.

How the money moves

You hold a crypto fund with AliX, and it backs everything you do. When you create an order, AliX debits the fund at the quoted rate and pays the recipient in their local currency. Orders settle asynchronously: the outcome reaches you by webhook, and orders/details confirms it on demand. If a payout cannot complete, the debited amount is returned to your fund.

ServiceUse it to
Scan-to-PayLet your user pay a merchant by QR code. Decode the QR, quote it, pay it.
CashoutPay fiat out to a recipient's bank account directly.

An integration at a glance

  1. Authenticate — sign every request with your RSA private key. See Authentication.
  2. Onboard the user — submit their KYC once and wait for VERIFIED. See KYC.
  3. Quote — preview the crypto cost and the fees before committing to an order.
  4. Create the order — with your own externalOrderId, which doubles as the idempotency key. See Scan-to-Pay and Cashout.
  5. Settle — receive the webhook, then confirm with orders/details. See Webhooks.

Quick start walks all five steps with runnable code.

Environments

EnvironmentBase URL
Sandboxhttps://sandbox.alixpay.com
Productionhttps://api.alixpay.com

Build and test against the sandbox first.

Where to go next

  • Quick start — an end-to-end integration: verify your account, sign a request, onboard a user, quote, create an order, settle it.
  • API Reference — the signing scheme, the response envelope, every error code, and the full request and response tables for all 16 endpoints.