API Integration

Introduction

The merchant calls up a checkout counter, and the user pays with cryptocurrency. After the user pays with cryptocurrency at the front end, we send order information via webhook.

Merchant can check more details at the merchant dashboard.

Quick Start

Before starting integration, you need to obtain the customerNum and secret for technical integration. Please contact our business team to obtain the appid and secret for the production environment.

Before obtaining your production environment account, you can integrate with our test environment first.

Please contact us for sandbox environment account.

Environmental Information

Sandbox Environment: https://crypto-payment-sbx.alchemytech.cc
Production Environment: https://crypto-payment.alchemytech.cc

Merchant Configuration

These information should be given for configuration.

Configuration itemsMandatoryDetails
Merchant LogoYDisplay at the top of the checkout
Main Button ColourNAccording to the standard below
TokenYDefault option includes all supported tokens
GatewayYPayment Channel
Payment SlippageNWith Configuration Method :± X%
Due to currency price fluctuations, when users use non-stable currencies for payment, if the user's payment is successful, the merchant will be paid at the current market price, and the settlement amount will have the fee deducted. If the loss exceeds the slippage set by the merchant, the payment will fail. If the ACH fee deducted is more than 1% of the order amount, it will not be settled to the merchant.
For example: if a merchant sets a 1% Payment Slippage, and a user orders 100U worth of a non-stable coin, after payment, if this non-stable coin slips to 98U worth, the order will fail and to be refunded. However, if this non-stable coin increases to 102U worth, the order will settle with 101U being paid to the merchant.
Without Configuration
If not configured, the customer assumes the risk of currency price fluctuations by default. After ACH receives the user's payment, it deducts the ACH fee and settles the whole amount to the merchant.
redirectURLYUser returns to the merchant's designated default page in any case
Settlement CurrencyYGeneral settlement token: USDT
Settlement fiat currency to be configured: USD, EUR, HKD, VND, IDR, THB
Settlement AddressYToken address receiving settlement
IP WhitelistYFor security reasons, the merchant's export IP needs to be whitelisted
Domain WhitelistYFor security reasons, the merchant's Domain needs to be whitelisted
Transaction FeeYUser Responsibility / Merchant Responsibility
Example: Order amount $100, fee rate 3%

Merchant Responsibility:
The merchant absorbs the transaction fee cost. The user pays $100, and the merchant is charged a fee of $3. Therefore, the settlement amount for the merchant is $100 - $3 = $97.

User Responsibility:
The user covers the merchant's transaction fee. For an order amount of $100, the user pays $103, and the fee is $3. Thus, the settlement amount for the merchant remains $100.

Refund Rules for Orders

The following four situations will trigger the automatic refund process on ACH page.

Users can initiate an automatic refund process on the interface by filling out refund details.

Otherwise, the order amount will be settled to the merchant if the user uncompleted the refund on ACH side.

Fail reasonFail type
Sending amount lower than order amount, order failedlower_amount
When the merchant has set payment slippage, the difference in the floating exchange rate of the payment token is greater than the payment slippage, causing the payment amount to be less than the order amount, an automatic refund will be triggeredcurrency_fluctuation
User send crypto with different crypto or networkwrong_payment
Payment success and amount over order amount more than ≥5U/