通过加密资产收款
商家平台可以通過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: 10031 | 10031 |
| 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 | 支付完成後跳轉URL | https://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 | 是 | 0 | 0-處理成功，其他-處理錯誤，具體參見錯誤碼 |
| msg | 否 | Signing failure | 具體錯誤原因，如：簽名失敗、參數格式校驗錯誤 |
| sign | 否 | CCD9083A6DAD9A2DA9F668C3D4517A84 | 對資料中的資料進行簽名。如果資料為空，則不會傳回。 |
| data | 否 | {} | 返回支付訂單，json格式資料。請參閱下面支付訂單 |
data：
| 參數名稱 | 範例 | 描述 |
|---|---|---|
| payOrderId | U12021022311124442600 | 必填.返回付款系統訂單編號 |
| mchOrderNo | 20160427210604000490 | 必填返回商家傳入的訂單編號 |
| orderState | 2 | 必填付款訂單狀態 0-已產生訂單 1-付款中 2-付款成功 3-付款失敗 4-已取消 5-已退款 6-訂單已關閉 |
| payDataType | payUrl | 必填付款參數類型 payUrl-跳轉連結方式 form-表單方式 codeUrl-二維碼位址 codeImgUrl-二維碼圖片位址 none-null支付參數 |
| payData | https://passtoppay.io/payment?prepay_id=f7b313532e90be28a8 | 待支付連接 |
| errCode | ACQ.PAYMENT_AUTH_CODE_INVALID | 通道傳回的錯誤碼 |
| errMsg | Business 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"
}