统一响应参数
以下支付,查询,退款,撤销,关闭订单的响应参数为统一响应参数中的业务参数,封装在 data 中。
支付接口
请求地址:https://xlink.91xft.cn/transaction/unify/charge/pay
请求参数
响应参数
支付凭证 credential 说明
WECHAT_LITE / WECHAT_OFFICE_ACCOUNT
WECHAT_H5 / ALIPAY_H5 / BALANCE_PAY:
h5_url (String) - 支付跳转链接
WECHAT_APP: prepay_id (String) - 预支付交易会话标识
ALIPAY_FIXED_QRCODE: trade_no (String) - 支付宝返回的售易号
CASHIERPAY: url(收银台地址), form(调起收银台form表单)
WECHAT_DYNAMIC_SCAN_CODE / ALIPAY_DYNAMIC_SCAN_CODE: qr_code (String) - 二维码码串
ALIPAY_APP: orderString (String) - 预支付参数
B2B_PAY: form (String) - form 表单
APP_TO_WECHAT_LITE: lite_username, lite_appid, path
系统返回的应答或通知消息可能会由于升级增加参数,请验证通知签名或处理应答报文时注意允许这种情况。
支付接口 V2
请求地址:https://xlink.91xft.cn/transaction/v2/unify/charge/pay
参数及响应与支付接口一致,响应额外返回 payer_id 付款人标识。
定额聚合支付
请求地址:https://xlink.91xft.cn/transaction/unify/charge/qrPrePay
请求参数
credential:
qr_code (String) 二维码码串,qr_code_img_url (String) 图片 url。
订单查询
请求地址:https://xlink.91xft.cn/transaction/unify/charge/query
支付订单和退款订单都用该接口查询。
请求参数:app_id, merchant_code, out_trade_no(与 third_trade_no 任一必传), third_trade_no, client_ip, extra, sign_type, sign。
响应参数
申请退款
请求地址:https://xlink.91xft.cn/transaction/unify/charge/refund
请求参数
撤销交易
请求地址:https://xlink.91xft.cn/transaction/unify/charge/cancel
请求参数: app_id, merchant_code, out_trade_no, third_trade_no(否), out_cancel_no, subject, body, description, extra, sign_type, sign。
关闭订单
请求地址:https://xlink.91xft.cn/transaction/unify/charge/close
请求参数: app_id, out_trade_no, merchant_code, subject, body, description, extra, sign_type, sign。
订单通知
支付完成后,统一平台系统会把支付结果发送给商户,商户需要接收处理,并返回应答。通知频率为 15/15/30/180/1800/1800/1800/1800/3600,单位:秒。通知参数不需要加入统一响应参数 data 中。
返回:处理成功返回 SUCCESS,不分大小写。
退款订单通知
暂只支持 channel 为 WECHAT / SXF / IPSPAY,其他支付渠道为同步退款或可通过查询接口查询。下载对账
请求地址:https://xlink.91xft.cn/settle/bill/download/query
请求参数: app_id, merchant_code, sign, sign_type, bill_date(yyyyMMdd), bill_type(1-对账单)。响应返回 bill_download_url。
下载渠道对账
请求地址:https://xlink.91xft.cn/settle/bill/agent/download/query
请求参数: app_id, agent_code, sign, sign_type, bill_date, bill_type(1-对账单, 3-结算文件)。响应返回 bill_download_url。
下载结算文件
请求地址:https://xlink.91xft.cn/settle/bill/download
请求参数: app_id, merchant_code, sign, sign_type, bill_date。响应返回 bill_download_url。
收款设备获取商户支付信息
请求地址:https://xlink.91xft.cn/transaction/device/query/pay/info
请求参数: app_id, device_sn, sign。响应参数包括 md5_key, device_sn, merchant_code, store_code, operator_id, sign, app_id。
支付验证码
请求地址:https://xlink.91xft.cn/transaction/unify/charge/sms
请求参数: app_id, sign_type, sign, merchant_code, wc_user_id。响应 check_code 有效期900秒。
当日订单流水
请求地址:https://xlink.91xft.cn/settle/transaction/out/pos/list
请求参数: app_id, sign_type, sign, merchant_code, store_code(否), operator_id(否), limit, offset。
响应字段包括:id, createTime, outTradeNo, platTradeNo, thirdTradeNo, merchantFullName, merchantCode, storeFullName, storeCode, operatorId, operatorName, institutionName, productCodeDesc, stateDesc, amount, discountAmount, totalAmount, preRateAmount, channelTradeNo, productCode, institutionCode, refundAmount, state, successTime, tradeDate。
