Introduction

This interface can be used when accessing Crypto Payment on telegram. ACH returns a web url and pulls up a page for user payment.

Regarding telegram bot, three usage modes are provided, depending on which front-end the merchant pulls up the payment page.

1. Browser mode: The merchant pulls up the weburl in the browser, and the payment page will be opened in the browser. After payment, it will jump to the redirectURL uploaded by the merchant
2. MINIAPP mode: The merchant pulls up the weburl in the miniapp, and the payment page will be embedded in the miniapp. The pop-up window will be closed after the payment is successful.(No need to uploaded redirectURL)
3. Bot mode: The merchant pulls up the ACH's bot, and jumps back to the merchant's bot after the payment is successful.

❗️

Abnormal Transaction Handling Rules

1. For deposit transactions that are not currently supported by the platform's automatic recognition system, including Internal Transactions, unofficial TON deposits, SUI MoveCall transactions, and other unsupported transaction types, funds cannot be credited automatically. Users may contact customer support and submit the relevant transaction information for manual processing upon verification. A service fee of 47 USDT per transaction will apply.
2. For cryptocurrencies that require a Memo, Tag, or Payment ID, if the deposit fails to be credited due to incorrect Memo/Tag information, users must provide the relevant transaction details and apply for manual processing. A service fee of 31 USDT per transaction will apply. Requests submitted more than 15 days after the deposit date will not be accepted.
3. If a withdrawal sent to a third-party platform is returned to the original withdrawal address due to reasons attributable to the receiving platform, users must provide supporting documentation and submit a request for manual asset recovery. A service fee of 47 USDT per transaction will apply. Requests submitted more than 15 days after the return date will not be accepted.
4. For transactions flagged by KYT (Know Your Transaction) risk monitoring, the platform will conduct a case-by-case review and may require users to provide additional supporting documentation. If the assets need to be returned to the original source address, a service fee of 5 USDT per transaction will apply.

Description of unsupported transfer types

API Description

Request Method:POST

Request Path:open/api/tg/payment/V2

Parameters

Request parameters

Telegram Front-end Display Mode

Pay Type

Exchange Codes

Wallet Codes

Pay Currency

Request Example

{
    "appId": "6fdbaac29eb94bc6b12345ad705e9293",
    "callbackURL": "https://crypto-payment-sbx.aeon.cc/crypto/bot/cpCallback",
    "customParam": "{\"botName\":\"ABCDCryptoPaymentTestBot\",\"orderDetail\":\"ABDC Test BAG 🎒\",\"chatId\":\"6831529261\"}",
    "expiredTime": "999999",
    "merchantOrderNo": "17243134568514",
    "orderAmount": "10",
    "orderModel": "ORDER",
    "payCurrency": "USD",
    "sign": "TEST000001",
    "tgModel": "MINIAPP",
    "userId": "[email protected]"
}

Description of Response Parameters

Response Example

{
    "code": "0",
    "model": {
        "orderNo": "300217243809185440066",
        "webUrl": "https://sbx-crypto-payment.aeon.org?orderNum=300217243809185440066"
    },
    "msg": "success",
    "traceId": "66c7f6f6f7e8c1827f4fe27905f96546"
}