Create an order

POST /api/v2/orders/create-sell-order

Allows your customer to create an order with the corresponding fiat amount

Supported fiat currencies.

• VND 🇻🇳

• PHP 🇵🇭

• THB 🇹🇭

• GLE (Georgia) 🇬🇪

• BRL 🇧🇷

• ARS 🇦🇷

• PEN 🇵🇪

Please noted for new field "fiatCurrency"

Alix Pay required two new parameters from partner's integration

userEmail and userKYCVerified

Headers

Name	Value
Content-Type	application/json
lang	The default will en if this param has been empty. Supported languages:en|cn|vi

Request Body

Vietnam 🇻🇳

• VietQR

Example of request data payload

{
  "externalOrderId": "f1a2acc8-c865-44fe-8e6d-d0857ada4d37",
  "partnerCode": "kaiAlinex",
  "signature": "I7XDfTngWIraq----J6lN/Aw==",
  "webhookSecretKey": "81663eae----83636b86b",
  "currency": "USDT",
  "bankCode": "TECHCOMBANK",
  "bankAccountNumber": "888812345678",
  "content": "payment",
  "userKYCVerified": true,
  "userEmail": "[e-mail]"
  "fiatAmount": 10000,
  "fiatCurrency": "VND",
  "extendInfo":null
}

Phillippines 🇵🇭

• P2P(Pear-to-Pear) QRCode

Example of request data payload

{
  "externalOrderId": "f1a2acc8-c865-44fe-8e6d-d0857ada4d37",
  "partnerCode": "kaiAlinex",
  "signature": "I7XDfTngWIraq----J6lN/Aw==",
  "webhookSecretKey": "81663eae----83636b86b",
  "currency": "USDT",
  "fiatAmount": 10,
  "bankCode": "UBPHPHMM",
  "bankAccountNumber": "109645950075",
  "content": "content payment",
  "fiatCurrency": "PHP",
  "extendInfo": {
    "qrType": "com.p2pqrpay",
    "PH": {
      "recipientName": "Sophia Marie Chavez Dever",
      "additionalData": {
        "merchantMobileNumber": "",
        "merchantCity": "SAN PEDRO",
        "crcCode": "3708",
        "purpose": "",
        "mobileNumber": "",
        "tfrName": "Sophia Marie Chavez Dever",
        "tfrBnkCode": "UBPHPHMMXXX",
        "userId": "",
        "paymentType": "99964403",
        "customerLabel": "",
        "merchantCategoryCode": "6016",
        "tfrAcctNo": "109645950075",
        "postCode": "",
        "uniqueId": "com.p2pqrpay",
        "loyaltyNumber": ""
      }
    }
  }
}

• P2M(Pear-to-Merchant) QRCode

Example of request data payload

{
  "externalOrderId": "f1a2acc8-c865-44fe-8e6d-d0857ada4d37",
  "partnerCode": "kaiAlinex",
  "signature": "I7XDfTngWIraq----J6lN/Aw==",
  "webhookSecretKey": "81663eae----83636b86b",
  "currency": "USDT",
  "bankCode": "UBPHPHMM",
  "bankAccountNumber": "109645950075",
  "content": "payment",
  "userKYCVerified": true,
  "userEmail": "[e-mail]"
  "fiatAmount": 10,
  "fiatCurrency": "PHP",
  "extendInfo": {
    "qrType": "com.p2pqrpay",
    "PH": {
      "recipientName": "VIETNAMIT BISTRO",
      "additionalData": {
        "merchantMobileNumber": "",
        "merchantCity": "PARANAQUE",
        "purpose": "",
        "referenceLabel": "TNcpj6J5F8BVLXUDrJSqno",
        "tfrName": "VIETNAMIT BISTRO",
        "tfrBnkCode": "PAPHPHM1XXX",
        "proxyNotify": "310",
        "storeLabel": "",
        "paymentType": "",
        "customerLabel": "",
        "terminalLabel": "",
        "merchantId": "200690490",
        "merchantCategoryCode": "5814",
        "tfrAcctNo": "200690490",
        "acqInfo": "",
        "postCode": "",
        "uniqueId": "ph.ppmi.p2m",
        "loyaltyNumber": ""
      }
    }
  }
}

Thailand(Phuket) 🇹🇭

Example of request data payload

{
  "externalOrderId": "f1a2acc8-c865-44fe-8e6d-d0857ada4d37",
  "partnerCode": "kaiAlinex",
  "signature": "I7XDfTngWIraq----J6lN/Aw==",
  "webhookSecretKey": "81663eae----83636b86b",
  "currency": "USDT",
  "fiatAmount": 0,
  "bankCode": "Ethereum Mainnet",
  "bankAccountNumber": "0xA51Aa2cBe4ab28D4D146d7934cfB1C241aB33c57",
  "content": "Payment",
  "fiatCurrency": "THB",
  "extendInfo": {
    "qrType": "thailand.pwc",
    "TH": {
      "recipientName": "0xA51Aa2cBe4ab28D4D146d7934cfB1C241aB33c57",
      "additionalData": {
        "timestamp": "2025-05-29T08:19:13.006Z",
        "chainCode": "ETH",
        "recipientAddress": "0xA51Aa2cBe4ab28D4D146d7934cfB1C241aB33c57",
        "tokenSymbol": "USDC",
        "tokenAmount": 99
      }
    }
  }
}

Georgia 🇬🇪

Example of request data payload

{ "externalOrderId": "f1a2acc8-c865-44fe-8e6d-d0857ada4d37", "partnerCode": "kaiAlinex", "signature": "I7XDfTngWIraq----J6lN/Aw==", "webhookSecretKey": "81663eae----83636b86b", "currency": "USDT", "fiatAmount": 1, "bankCode": "Georgia QR Pay", "bankAccountNumber": "Georgia QR", "content": "content payment", "userKYCVerified": false, "fiatCurrency": "GEL", "userEmail": "[e-mail]", "extendInfo": { "qrType": "georgia.customer.k", "GE": { "recipientName": "Demo Merchant", "additionalData": { "infoPayment": "921b43b4d693d90feeb4616dd199286d:273940c3d928b6cc5aa34c87a191dc28a316668ee0249fe2b07c0cc5544aea714de04ea681914ec2f58081195025a5b1" } } } }

Brazil 🇧🇷

Example of request data payload

{
    "externalOrderId": "3532edba-d19d-4a1b-a803-936a38740e65",
    "partnerCode": "kaiAlinex",
    "signature": "PRZHIYyQoOlKWO1SM8cchRl7xk5zgGcwijTNBoVN5THesQk3KP9xxtz1wMw9Iy6d3NtUuv74kvFp5bBRK2KLI2GTK0nreQKsRYkIRWcOnxnL6LFHyADmi+uppyy/LQVEZA7h2Ll9yT5WU2BKfxhfc7WQtzhWmche1gNWwO2ciiGZnMzHHRXfFkrhKROzKaE1N4bR2+MzrDiWBxm61sI29B2p3VW89P1CiyT2DOa+mQZDu76GP76OxrqrFQ5D0Xw6nIDNBksrQDrMMI76xij24zeIyjovog6rsoJIexjKEFx1EYlpjWNvlO3yDE2whIXvBNjejqZQQRZEwyyeBUdCUw==",
    "currency": "USDT",
    "fiatAmount": 4,
    "bankCode": "PIX BR",
    "bankAccountNumber": "12345678909",
    "content": "content payment",
    "userKYCVerified": true,
    "fiatCurrency": "BRL",
    "userEmail": "[e-mail]",
    "extendInfo": {
      "qrType": "PIX",
      "BR": {
        "recipientName": "Chiquinho Santos",
        "additionalData": {
          "infoPayment": "pixfailure"
        }
      }
    }
  }

Argentina 🇦🇷

Example of request data payload

{
    "externalOrderId": "ca129241-2d47-467f-b86c-00a0dc56f970",
    "partnerCode": "kaiAlinex",
    "signature": "Pd4QWgP4XrKrdcYYLenGqTqPa0nYeCmzFw8SrYboun7zOba9NWrSOVX8r3pJ7CLMbPRZPUxAely9qadjvxkjJI5PWLq8fVVL5r9FoITuJrtSSGYZmkQAhG+Vn1nGLWAG0ZBYSp9G/KNIepGBInM/EfBYa/JrRIehmZRRN7YfClsNU9z6UlNEsTxYkMxG4+VcbvC4gNEcu6F/zB1pTSTQtuAkeumkNV2se+RZv6a6F+GS35qSDPPZ8ILHd+QEdn+85teSmHcdoDiaga7hoiX59+oJfXWfzxOz/tjB4uU+Nvg/JI4vPJvGKh69C1H/HXpjBV3zVGDbUVX3b6B1+TNa3g==",
    "currency": "USDT",
    "fiatAmount": 1224.54,
    "bankCode": "QR3 AR",
    "bankAccountNumber": "20065533016",
    "content": "content payment",
    "userKYCVerified": true,
    "fiatCurrency": "ARS",
    "userEmail": "[e-mail]",
    "extendInfo": {
      "qrType": "QR3",
      "AR": {
        "recipientName": "Ricardo Fort",
        "additionalData": {
          "infoPayment": "00020101021140200010com.yacare02022350150011336972350495204739953030325802AR5910HAVANNA SA6012BUENOS AIRES81220010com.yacare0204Y2156304E401refund"
        }
      }
    }
  }

Peru 🇵🇪

Example of request data payload

{
    "externalOrderId": "ca129241-2d47-467f-b86c-00a0dc56f970",
    "partnerCode": "kaiAlinex",
    "signature": "Pd4QWgP4XrKrdcYYLenGqTqPa0nYeCmzFw8SrYboun7zOba9NWrSOVX8r3pJ7CLMbPRZPUxAely9qadjvxkjJI5PWLq8fVVL5r9FoITuJrtSSGYZmkQAhG+Vn1nGLWAG0ZBYSp9G/KNIepGBInM/EfBYa/JrRIehmZRRN7YfClsNU9z6UlNEsTxYkMxG4+VcbvC4gNEcu6F/zB1pTSTQtuAkeumkNV2se+RZv6a6F+GS35qSDPPZ8ILHd+QEdn+85teSmHcdoDiaga7hoiX59+oJfXWfzxOz/tjB4uU+Nvg/JI4vPJvGKh69C1H/HXpjBV3zVGDbUVX3b6B1+TNa3g==",
    "currency": "USDT",
    "fiatAmount": 1224.54,
    "bankCode": "QR3 PE",
    "bankAccountNumber": "20065533016",
    "content": "content payment",
    "userKYCVerified": true,
    "fiatCurrency": "PEN",
    "userEmail": "[e-mail]",
    "extendInfo": {
      "qrType": "QR3",
      "AR": {
        "recipientName": "Ricardo Fort",
        "additionalData": {
          "infoPayment": "00020101021140200010com.yacare02022350150011336972350495204739953030325802AR5910HAVANNA SA6012BUENOS AIRES81220010com.yacare0204Y2156304E401refund"
        }
      }
    }

Nigeria 🇳🇬

Example of request data payload

{
    "externalOrderId": "92d6a08b-1200-463a-802d-1e675b38c600",
    "partnerCode": "kaiAlinex",
    "signature": "S8vAeU0PId5/xsikasEx0rcan13qG9b+BehZ+CFRSD6YbBxSqLQCe2dtvTX63Ip1/V4kjwC8LLEBm+XShLajCnKtA6urulReb3Ig/zlj5NDb9sGtH2p0mvkZI7252BDwgQ9/4hkMWax4e/DvBBo57lDDOsDncwB5bFCcU+umP34wWv1bwox/i0kU1h6FkcQBbqXguivMN+tRuKLghs6P7SS4NsTuzDJ5w3bXuO/4FyG225Ow68DVSyhmCnP7qRDQl4ZTYcT0n75ZViXblXER3FqVo8rW2e1DEM05gTEq+0ELHTosbYfaHPjdMkVZv0E6I/4z5Nq9+62aehMWDk+nJA==",
    "currency": "USDT",
    "bankCode": "000004",
    "bankAccountNumber": "2184648058",
    "content": "payment home 123",
    "userKYCVerified": true,
    "userEmail": "[e-mail]",
    "fiatAmount": 4000,
    "fiatCurrency": "NGN",
    "extendInfo": null
  }

Name	Type	Condition	Description
partnerCode	string	required	Code of of the partner
userEmail	string	required	The email address from the end-user of your application
userKYCVerified	boolean true | false	optional	The user's KYC status on your application
currency	string	required	cryptocurrency that you wants to sell. for example: USDT | ETH | BTC
fiatCurrency	string	optional	Supported fiat currencies: VND PHP THB GEL BRL ARS PEN NGN (If the field is empty. Default will be VND)
fiatAmount	number	required	The amount of fiat (VND) the user wants to sell. The minimum value should be: VND 10000 (Sandbox: 50000) PHP: 10 THB: 0 IDR: 10000 GEL: 1 BRL: 1 ARS: 1 PEN: 1 NGN: 1
bankCode	string	required	Code of bank
bankAccountNumber	string	required	bank account number wants to send to fiat
content	string	optional	Content of transaction
webhookSecretKey	string	required	It is secret key created by partner dashboard
signature	string	required	The signature created with SHA256 by using RSA created private key of partner The public key that has been provided to you during onboarding. The data shall be signed according to the structure: partnerCode|externalOrderId|currency|fiatAmount|bankCode|bankAccountNumber|content|userEmail|secretKey
externalOrderId	string	required	This unique id for order created and managed in partner side. It will keep the update for transaction status after created it
extendInfo	Object	Optional	Only Apply for ScanToPay The additionalData getting from api get the information of QRCode Vietnam "extendInfo": null Phillipines "extendInfo": { "qrType": "com.p2pqrpay", "PH": { "recipientName": "VIETNAMIT BISTRO", "additionalData": { "merchantMobileNumber": "", "merchantCity": "PARANAQUE", "purpose": "", "referenceLabel": "TNcpj6J5F8BVLXUDrJSqno", "tfrName": "VIETNAMIT BISTRO", "tfrBnkCode": "PAPHPHM1XXX", "proxyNotify": "310", "storeLabel": "", "paymentType": "", "customerLabel": "", "terminalLabel": "", "merchantId": "200690490", "merchantCategoryCode": "5814", "tfrAcctNo": "200690490", "acqInfo": "", "postCode": "", "uniqueId": "ph.ppmi.p2m", "loyaltyNumber": "" } } }
extendInfo.recipientName	string	Optional	it should be used the tfrName field from the api get the content of QRcode
extendInfo.additionalData	Object	Optional	it should be used the additionalData field from the api get the content of QRcode
qrType	string	qrType	It belong to extendInfo Object and getting from API - VN: "vietqr" - PH: "ph.ppmi.p2m | com.p2pqrpay" - TH: "thailand.pwc" - ID: "qris"
countryCode	string	Optional	the countryCode getting from api get the information of QRCode VN: 🇻🇳 PH: 🇵🇭 TH: 🇹🇭 GE: 🇬🇪 BR: 🇧🇷 AR: 🇦🇷 PE: 🇵🇪 NG: 🇳🇬

Response

200

{
  "externalOrderId": "string",
  "type": "string",
  "fiatAmount": 0,
  "paidAmount": 0,
  "tokenTransfer": {
    "currency": "string",
    "network": "string",
    "price": 0,
    "amount": 0,
    "walletAddress": "string",
    "txHash": "string"
  },
  "bankTransfer": {
    "bankAccountName": "string",
    "bankAccountNumber": "string",
    "bankName": "string",
    "contentPayment": "string",
    "totalPayment": 0,
    "qrUrl": "string"
  },
  "fees": {
    "systemFee": 0,
    "processingFee": 0
  },
  "status": "string", // AWAITING_PAYMENT | PAYMENT_COMPLETED | PROCESSING_TOKEN_TRANSFER | SUCCESS | ERROR 
  "description": "string",
  "createdAt": "string",
  "expiresAt": "string",
  "signature": "string"
}

400

Signature

• Partner will digitally sign the transmitted data using SHA256 with RSA algorithm

• The private key that has been of yours

• Data shall be signed according to the structure externalOrderId|type|fiatAmount|status|secretKey

How to create and verify the signature

1. Creation

import * as crypto from 'crypto';

function create(data: string, privateKey: string): string 
{
  const signer = crypto.createSign('RSA-SHA256');
  signer.update(data);
  signer.end();

  return signer.sign(privateKey, 'base64');
}

2. Verification

function verify (data: string, signature: string, pubKey: string): boolean
{
        const verify = createVerify('RSA-SHA256');
        verify.update(data);
        verify.end();
        return verify.verify(pubKey, signature, 'base64');
}

Transaction status

Status name	Description
AWAITING_PAYMENT	The order created successfully. It is waiting (please wait IPN or manual check with operation)
PAYMENT_COMPLETED	When payment has transferred from AliX Pay to your customer bank account
PROCESSING_TOKEN_TRANSFER	When the token has deducted from your account wallet on AliX Pay
SUCCESS	When an transaction has completed
FAIL	When an transaction has failed with any reasons
ERROR	When an transaction has failed with any reasons