1. 简介

QLink支付对接标准文档

2. 环境要求及基础约定

授权：联系QLink获取appKey、appSecret（密钥，用于验证报文信息）。

接口地址：

线下：http://qlink-global-test.800best.com/global-api/v1/pay

生产：http://qlink-global.800best.com/global-api/v1/pay

请求方式：

• Method: POST
• Content-Type: application/json

Header参数:

公共响应:

签名方式:

1、将appKey和content组成json字符串{"appKey":"appKey","content":"具体业务参数"}，content为空时{"appKey":"appKey"}。

2、将第三方分配的客户appSecret添加到json的末尾，得到待加密字串{"appKey":"appKey","content":"具体业务参数"}appSecret。

3、对待加密字串做sha1加密得到签名（org.apache.commons.codec.digest.DigestUtils.sha1Hex(待加密字串)）

4、将签名赋值到公共请求的sign字段

3. 查询支付账户

url:

• /queryPayAccount

接口参数:

返回信息:

请求示例: { "payAccount": "account1" }

返回示例:

[ { "serviceProvider": "xendit", "type": "PAY" "channelCode": "QRIS", "desc": "", "country": "ID", "currencyList": ["IDR", "PHP", "VND", "THB", "SGD", "MYR", "USD"], } ]

4. 支付申请

url:

• /apply

接口参数:

返回信息:

请求示例:

{ "payAccount": "account1", "type": "ONLINE", "channelCode": "QRIS", "channelProperties": { "expires_at": "2025-08-11T23:59:59Z" }, "tradeUuid": "uuid", "tradeTime": "2025-08-04 13:45:21", "orderCode": "O20250804001", "country": "ID", "currency": "IDR", "amount": 1, "description": "描述", "metadata": "", "items": [ { "code": "SKU01", "type": "DIGITAL_PRODUCT", "name": "商品01", "netUnitAmount": 1, "quantity": "1", "url": "http://", "imageUrl": "http://", "category": "", "subcategory": "", "description": "", "metadata": "" } ] }

返回示例:

{ "billCode": "账单号", "paymentRequestId": "11111", "actionList": [ { "type": "", "descriptor": "", "value": "" } ] "errorCode": "" }

5. 模拟支付（xendit）

url:

• /simulatePay

接口参数:

请求示例:

{ "payAccount": "account1", "tradeUuid": "uuid", "billCode": "billCode", "source": "QERP_CN" }

6. 查询支付状态

url:

• /getPayStatus

接口参数:

返回信息:

请求示例:

{ "tradeUuidList": ["uuid1"], "billCodeList": ["billCode1"], "source": "QERP_CN" }

返回示例: [ { "amount": 1, "billCode": "billCode1", "currency": "IDR", "errorCode": "", "orderCode": "O20250804001", "payTime": "", "paymentRequestId": paymentRequestId"", "status": "PAY_WAIT", "tradeUuid": "uuid1" }, { "amount": 2, "billCode": "billCode2", "currency": "IDR", "errorCode": "", "orderCode": "O20250804002", "payTime": "2025-08-04 13:45:21", "paymentRequestId": "paymentRequestId", "status": "PAY_SUCCESS", "tradeUuid": "uuid2" } ]

7. 取消支付

url:

• /cancel

接口参数:

返回信息:

请求示例:

{ "tradeUuid": "uuid1", "billCode": "billCode1", "source": "QERP_CN" }

返回示例:

{ "status": "WAIT", "cancelTime": "", "errorCode": "" }

8. 退款

url:

• /refund

接口参数:

返回信息:

请求示例:

{ "refundUuid": "uuid1", "tradeUuid": "uuid1", "source": "uuid1", "billCode": "billCode1", "orderCode": "S0001", "amount": 1000, "reason": "REQUESTED_BY_CUSTOMER", "metadata": "" }

返回示例:

{ "status": "REFUND_SUCCESS", "refundTime": "", "errorCode": "" "errorMsg": "" "platformRefundId": "" }

9. 退款查询

url:

• /queryRefund

接口参数:

返回信息:

请求示例:

{ "source": "QERP_CN", "tradeUuid": "uuid1", "billCode": "billCode1", "refundUuid": "uuid1", "refundBillCode": "" }

返回示例:

[ { "tradeUuid": "uuid1", "billCode": "billCode1", "refundUuid": "refundId", "refundBillCode": "refundBillCode", "orderCode": "O20250804001", "status": "WAIT", "refundTime": "", "errorCode": "" "platformRefundId": "" } ]

10. Webhook

11. 支付状态通知

url:

• /qlink/payNotification

接口参数:

请求示例:

{ "tradeUuid": "uuid1", "billCode": "billCode1", "orderCode": "O20250804001", "paymentRequestId": "O20250804001", "status": "WAIT", "payTime": "", "errorCode": "" "notificationTime": 1756191428000 }

12. 退款通知

url:

• /qlink/refundNotification

接口参数:

请求示例:

{ "refundUuid": "refundId", "refundBillCode": "refundBillCode", "tradeUuid": "uuid1", "billCode": "billCode1", "orderCode": "O20250804001", "status": "WAIT", "refundTime": "", "errorCode": "" "notificationTime": 1756191428000, "platformRefundId": "" }