Guides
Alchemy Pay

推送说明

Suggest Edits

介绍

当用户在买币/卖币时，我们会根据用户买卖笔的结果给商家推送订单信息。

❗️

注意：目前通知仅推送 1 次，强烈建议接入订单查询接口

接口说明

路径：POST 商家接口定义

买币回调

参数

参数名类型说明备注
appidstring商户应用的唯一标识
orderNostring系统订单号
emailstring用户的邮箱
cryptostring用户购买的数字货币币种
cryptoPricestring用户购买的数字货币价格
cryptoQuantitystring用户购买的数字货币数量
payTypestring用户购买的支付方式
fiatstring用户法币币种
amountstring用户支付的法币金额
payTimestring用户实际支付时间
networkstring用户购买的数字货币网络
addressstring用户提币的地址
txTimestring用户到账时间
txHashstring提现哈希
statusstring订单状态：PAY_FAIL、PAY_SUCCESS、FINISHED
messagestring支付失败原因
merchantOrderNostring商户orderNo
networkFeestring网络费单位：USD
rampFeestring服务费
signaturestringcallback签名，生成签名串为： getMersign(appId,appSecret,appId+orderNo+crypto+network+address)
#getMersign为API签名方式，签名方式可参考这里
fiatInUSDstring法币金额（以USD计价）status为FINISHED返回该参数。
rampFeeInUSDstring服务费（以USD计价）status为FINISHED返回该参数。
cryptoNetworkFeestring以购买的token计价status为FINISHED返回该参数。
networkFeeInUSDstring网络费（以USD计价），按cryptoNetworkFee计算成USD计价status为FINISHED返回该参数。
cryptoAmountInUSDTstring用户收到的的token（以USDT计价）status为FINISHED返回该参数。
rebateFiatAmountstring返佣数量，以法币计价
rebateUsdAmountstring返佣数量，以 USD 计价

以下参数需要配置才会推送，如有需求可以跟我们联系。

参数名类型说明
createTimestring订单创建时间，格式YYYY-MM-DD, HH:MM:SS，如2021-11-25 10:00:00
rampFeeUnitstringRamp fee的单位，如USD, ETH
tokenAddressstring买币时返回token的合约地址；如果是主链币没有合约地址，为空
alpha2stringISO 3166-1 二位字母国家code，如us/jp等

📘

注意：INR本地支付，法币支付完成这一步没有回调。

回调示例

# 支付成功回调
{
	"payTime": "2024-03-08 16:44:55",
	"txTime": "",
	"signature": "8f531563063e******fsf0f2ba147352dc56f",
	"networkFee": "",
	"rebateFiatAmount": "",
	"network": "TRX",
	"cryptoPrice": "1673.01240000",
	"payType": "QRIS",
	"rampFee": "0.00000000",
	"appId": "XXXXXXX",
	"fiat": "IDR",
	"newSignature": "ukoP+9tFT1Bd******ZF/3FZP7wNjSL3mY=",
	"txHash": "",
	"email": "[email protected]",
	"rampFeeInUSD": "0.00",
	"amount": "65000.00000000",
	"orderNo": "acv121******s603104256",
	"address": "TWhWAYBC25*****afYoahA9oS",
	"rebateUsdAmount": "",
	"message": "",
	"merchantOrderNo": "1ac******8sd3",
	"crypto": "USDT",
	"rampFeeUnit": "IDR",
	"cryptoQuantity": "37.77209300",
	"status": "PAY_SUCCESS"
}
# 订单完成回调
{
	"payTime": "2024-03-08 16:44:55",
	"txTime": "2024-03-08 16:47:03",
	"signature": "8f53******352dc56f",
	"networkFee": "15593.49991193",
	"rebateFiatAmount": "",
	"fiatInUSD": "41.68",
	"network": "TRX",
	"cryptoPrice": "16763.01240000",
	"payType": "QRIS",
	"rampFee": "0.00000000",
	"appId": "******",
	"fiat": "IDR",
	"newSignature": "inrA******8O3NpmsJU=",
	"txHash": "84b69e4e1d******0e39e90c0911",
	"email": "norh******[email protected]",
	"rampFeeInUSD": "0",
	"amount": "650000.00000000",
	"orderNo": "1215580630603104256",
	"address": "TWh******oS",
	"cryptoNetworkFee": "3.9",
	"networkFeeInUSD": "3.9",
	"cryptoAmountInUSDT": "37.772093",
	"rebateUsdAmount": "",
	"message": "",
	"merchantOrderNo": "112******3",
	"crypto": "USDT",
	"rampFeeUnit": "IDR",
	"cryptoQuantity": "37.77209300",
	"status": "FINISHED"
}

回调状态说明

状态说明
PAY_SUCCESS用户付款成功
PAY_FAIL用户付款失败
FINISHED打币成功，订单完成

PayType list

PayTypeNamePayway Code
CREDIT_CARDCredit Card10001
DEBIT_CARDDebit Card10002
DIRECTVirtual Account10003
QRISQRIS10004
DANADANA10005
OVOOVO10006
LINKQULINKQU10007
OPMOPM10008
TECH_CARDTech Card100
TECH_WALLETTech Wallet200
TECH_BANK_CARD_TRANSFERTech Bank Card Tran300
TECH_BANK_MO_MOMoMo201
TECH_BANK_ZALO_PAYZaloPay202
TECH_BANK_VIETTEL_PAYViettelPay203
TECH_BANK_GCASH_PAYGCash207
TECH_BANK_TOUCHGO_PAYTouch 'n Go208
TECH_BANK_KAKAO_PAYKakao Pay209
TECH_BANK_LINE_PAYLINE Pay206
TECH_BANK_DANA_PAYDANA205
BINANCE_PAYBinance Pay20001
PIX_PAYPix Pay30001
BANCNETBancnet80039
BPIBPI80040
UNION_BANkUNION_BANK80041
COINSCOINS80066
BDOBDO80068
RCBCRCBC80070
GCASHGCASH80059
QRPHQRPH90007
PAY_NOWPAY NOW40001
E_NETSE NETS40002
THAI_QRTHAI_QR40003
KHIPU_PAYKHIPU PAY30002
APPLE_PAYApple Pay501
VND_BANK_TRANSFERBank Transfer210
SPEISPEI601
ARS_BANK_TRANSFERBank Transfer30003
GOOGLE_PAYGoogle Pay701
ECU_BANK_TRANSFERBank Transfer11000
COP_PSEPSE12000
MYR_BANK_TRANSFERBank Transfer13000
UPIUPI90001
IMPSIMPS90002
PAYOUT_BANK_TRANSFERBank Transferpayout101
PERUPAYBank Transfer15000
EUROPAYBank Transfer16000
EUPAYBank Transfer17000
NGNPAYBank Transfer18000
YYH10010_CARDCard10010
NIUM19000_BANK_TRANSFERBank Transfer19000
GATEPAY_21000Gate Pay21000
SEPA InstantSEPA Instant60001
FPSFPS60002

卖币回调

参数

（不同状态可能有的值和字段为空）

参数名类型说明
orderNostringACH订单号
addressstring订单收币地址
payTimestringACH给用户转账的时间
completeTimestring订单收到数字货币确认的时间
merchantOrderNostring商户订单号
cryptostring卖币的数字货币
networkstring卖币的数字货币对应的网络
cryptoPricestring数字货币对应USD的价格
cryptoAmountstring订单上的数字货币数量
fiatAmountstring法币金额
appIdstringappID
fiatstring法币币种
txHashstring用户转账的hash
emailstring用户邮箱
signaturestringcallback签名，生成签名串为： getMersign(appId,appSecret,orderNo+crypto+network+address)
#getMersign为API签名方式
statusstring订单状态
orderAddressstring订单页面url
cryptoacturalAmountstring订单实际收到的数量
rampfeestring订单的手续费，币种与法币币种相同
receiptTimestring法币到账的时间
paymentTypestringcard为提现到卡，account为提现到账户
namestring卡或者账户姓名
cardstring卡信息展示前6后4，121321**1231
accountstring账户信息，展示后四位，****1231
failReasonstring失败原因

回调示例

{
  "orderNo": "1029386554223382528", /ACH订单号
  "address": "TGNMkik3nPaioVJdkE7qEixWr9cUvsyT5g",/订单收币地址
  "payTime": "2022-10-11 21:39:55",/ACH给用户转账的时间
  "completeTime": "2022-10-11 21:39:53", /订单收到数字货币确认的时间
  "merchantOrderNo": "null",/商户订单号
  "crypto": "USDT",/卖币的数字货币
  "network": "TRX",/卖币的数字货币对应的网络
  "cryptoPrice": "1.0000000000",/数字货币对应fiat的价格
  "cryptoAmount": "60.0000000000",/订单上的数字货币数量
  "fiatAmount": "86.7100000000",/用户到账的法币金额，不包含手续费
  "appId": "ahzxh0klegv1fzol",/appID
  "fiat": "SGD",/法币币种
  "txHash": "2bde306489a58f89d6ac1c8b2296b2cdf9866bdcd8b45acaea361477bb04e398",用户转账的hash
  "email": "[email protected]",/用户邮箱
  "signature":"ffaa29ee7f75cb52598fe460295caafa3ebcb549",/签名
  "status": "1" ,/订单状态
  "orderAddress": "xxxx" ,/订单页面url
  "cryptoacturalAmount": "60.0000000000",/订单实际收到的数量
  "rampfee": "",/订单的手续费，币种与法币币种相同
  "receiptTime": "2022-10-11 21:39:53", /法币到账的时间
  "paymentType": "xxxx" , card为提现到卡，account为提现到账户
  "name": "xxxx" ,卡或者账户姓名
  "card": "xxxx" ,卡信息展示前6后4，121321******1231
  "account": "xxxx" ,账户信息，展示后四位，****1231
  "failReason": "xxxx" ,失败原因
}

回调状态说明

状态说明
1订单创建成功
2用户打币完成
3开始打款
4打款成功
5打款失败
6退款成功
7订单超时

Updated 10 months ago