API Reference

創建數字幣支付訂單

通过加密资产收款

商家平台可以通過API發起支付訂單，PassToPasy網關會根據配置路由支付通道。支付網關根據不同的支付方式返回對應的支付參數，商家通過這些支付參數向客戶發起收款。

請求路徑 : api/pay/cryptoOrder

請求方式 : POST

請求類型 : application/json or application/x-www-form-urlencoded

請求參數

參數描述範例
mchNo必填.商家編號，在管理後台可查看。M1621873433953
appId必填.在管理後台可查看。60cc09bce4b0f1c0b83761c9
mchOrderNo必填.商家產生的訂單號碼。20160427210604000490
amount必填.付款金額， 最大支持小數位2位，請將金額*100後以整數類型表示 比如 金額為 100.31 USD,amount: 1003110031
currency必填。默認客戶支付的幣種 查看列表USDT
chain必填.默認支付的網路ID。查看列表1
userName發起付款的用戶真實姓名。張三
reqTime必填。請求API時間，13位時間戳。1622016572190
version必填 版本號，當前接口版本為：1.1。1.1
signType必填。簽名類型，目前僅支援MD5方式。MD5
sign必填。簽名值，詳細請參考請求簽名。C380BEC2BFD727A4B6845133519F3AD6
subject必填。產品標題，，不超过8个字符。yifu
body必填。產品描述，不超过8个字符。test cl
clientIp必填。用戶端 IPV4 位址210.73.10.148
custNo必填.商家客戶唯一的編碼C123111
registerTime必填.商家客戶註冊時間1622016572190
notifyUrl支付結果回調通知URL，只有傳入該值才會啟動通知https://www.yourserver.com/notify.htm
returnUrl支付完成後跳轉URLhttps://www.yourserver.com/return.htm
expiredTime訂單過期時間，單位秒，默認過期時間為2小時。3600
extParam商家擴充參數，回調時原樣返回134586944573118714

請求範例：

{
  "amount": 20,
  "extParam": "123",
  "mchOrderNo": "JOHN0026",
  "subject": "johntest",
  "reqTime": "1712829266129",
  "wayCode": "CRYPTO_ADDRESS",
  "body": "product Description",
  "version": "1.0",
  "appId": "65dbf06cd1bad488fdd8598b",
  "expiredTime": 600,
  "clientIp": "192.166.1.132",
  "notifyUrl": "https://www.paypass.com",
  "signType": "MD5",
  "currency": "USDT",
  "userName": "zhangsan",
  "mchNo": "M1702966122",
  "sign": "A4028F78054AC86FD21E9A3E053DFC25",
  "chain": "1",
  "custNo": "23333",
  "registerTime": "3333333333333333"
}

回應參數

參數必填範例描述
code是00-處理成功，其他-處理錯誤，具體參見錯誤碼
msg否Signing failure具體錯誤原因，如：簽名失敗、參數格式校驗錯誤
sign否CCD9083A6DAD9A2DA9F668C3D4517A84對資料中的資料進行簽名。如果資料為空，則不會傳回。
data否{}返回支付訂單，json格式資料。請參閱下面支付訂單

data：

參數名稱範例描述
payOrderIdU12021022311124442600必填.返回付款系統訂單編號
mchOrderNo20160427210604000490必填返回商家傳入的訂單編號
orderState2必填付款訂單狀態
0-已產生訂單
1-付款中
2-付款成功
3-付款失敗
4-已取消
5-已退款
6-訂單已關閉
payDataTypepayUrl必填付款參數類型
payUrl-跳轉連結方式
form-表單方式
codeUrl-二維碼位址
codeImgUrl-二維碼圖片位址
none-null支付參數
payDatahttps://passtoppay.io/payment?prepay_id=f7b313532e90be28a8待支付連接
errCodeACQ.PAYMENT_AUTH_CODE_INVALID通道傳回的錯誤碼
errMsgBusiness Failed通道傳回的錯誤描述

回應範例：

{
    "code": 0,
    "data": {
        "mchOrderNo": "JOHN003",
        "orderState": 1,
        "payData": "https://passtopay.io/payment?prepay_id=f7b313532e90be28a88faad5b669632b39e79deecb73151615d3e28e21393a17&locale=en",
        "payDataType": "payurl",
        "payOrderId": "P1779159480454324225"
    },
    "msg": "SUCCESS",
    "sign": "ABDD75BBA81037F76FE1FC72294A5964"
}