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 items | Mandatory | Details |
|---|---|---|
Merchant Logo | Y | Display at the top of the checkout |
Main Button Colour | N | According to the standard below |
Token | Y | Default option includes all supported tokens |
Gateway | Y | Payment Channel |
Payment Slippage | N |
|
redirectURL | Y | User returns to the merchant's designated default page in any case |
Settlement Currency | Y | General settlement token: USDT |
Settlement Address | Y | Token address receiving settlement |
IP Whitelist | Y | For security reasons, the merchant's export IP needs to be whitelisted |
Domain Whitelist | Y | For security reasons, the merchant's Domain needs to be whitelisted |
Transaction Fee | Y | User Responsibility / Merchant Responsibility Merchant Responsibility: User Responsibility: |
Refund Order Callbackurl | N | Url for receiving refund order webhook |
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 reason | Fail type |
|---|---|
| Sending amount lower than order amount, order failed | lower_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 triggered | currency_fluctuation |
| User send crypto with different crypto or network | wrong_payment |
| Payment success and amount over order amount more than ≥5U | / |
Updated 17 days ago