线上预授权支付API
常用API
对接开发环境的常规指引可以参考 https://sdk.qfapi.com/#introduction
在開始對接前,建議先參考以下內容:
- API凭据:在對接过程中,您将需要使用相应的API凭据来进行验证和授权。
- 测试环境:为了确保顺利的對接和开发,我们提供了测试环境,供您进行测试和调试。
- API请求签名生成:为了确保请求的安全性和完整性,您需要生成正确的API请求签名。详细的签名生成方法将在文档中提供。
- 常见错误代码:在对接过程中,了解常见的错误代码和对应的含义将有助于您更好地诊断和解决问题。
此外,我们还为预授权支付提供了以下常用API接口供您参考:
Creating and capturing payments
第一步: 創建预授权支付訂單
预授权步骤需要使用支付元素组件 (Payment Element) 来完成。有关對接的详细信息,请参考支付元素文档中相应的章节。
第二步: 预授权支付扣款
扣取客户在预授权交易中授权的金额
URL位址 : /trade/v1/authtrade
请求方法 : POST
HTTP 标头:
HTTP 标头 | 必填 | 描述 |
---|---|---|
X-QF-APPCODE | 是 | app code |
X-QF-SIGN | 是 | app key |
参数 :
参数 | 必填 | 描述 |
---|---|---|
txamt | 是 | 扣款金额 |
txcurrcd | 否 | 扣款币种 |
mchid | 否 | 商户编号(只适用于个别渠道商户) |
syssn | 是 | 预授权交易唯一订单号 |
回应 :
{
"sysdtm": "2024-02-26 15:04:12",
"paydtm": "2024-02-26 15:04:12",
"udid": "qiantai2",
"txcurrcd": "HKD",
"txdtm": "2024-02-26 07:04:11",
"txamt": "500",
"resperr": "交易成功",
"respmsg": "Capture received",
"out_trade_no": "",
"syssn": "20240226180500020000014116",
"orig_syssn": "20240226180500020000014079",
"respcd": "0000",
"chnlsn": "",
"cardcd": ""
}