跳到主要内容

QFPay 收银台服务

介紹​

欢迎使用 QFPay 安全收银台 本手册介绍了 QFPay 的托管收银台页面，开发者可以通过该页面向其在线商店添加多种支付方式。

收银台页面设计​

shouyintai

结帐页面具有完全响应能力，能自动调整以适应所有屏幕尺寸。 介面目前支持英语，简体中文以及繁体中文。 另外结帐页面可以根据商家的需求，例如可用的电子钱包以及设计和描述，进行配置 。 如果您有相關明确要求，请发送电子邮件至 technical.support@qfpay.com 寻求協助。

API环境​

注意

请记住立即通过商户管理系统、QFPay APP或开放API对测试交易进行退款。

下表描述了每个区域的基本 URL。

环境URL
线上测试环境https://test-openapi-hk.qfapi.com/checkstand/#/?
生产环境https://openapi-hk.qfapi.com/checkstand/#/?

流程​

shouyintai

消费者浏览商户的网站并继续付款。 一旦他们点击支付按钮，他们将被转发到 QFPay 托管的收银台页面。 在这里，消费者可以找到多种支付方式，可在桌面或移动设备上结账并完成支付。 付款成功后，用户将被重定向回商家网站以获取“付款成功通知”并继续浏览商店。

API請求參數​

GET https:test-openapi-hk.qfapi.com/checkstand/#/?..

创建新的结帐请求需要以下主体参数；

参数名称参数类型是否必填描述范例
appcodeString(64)是QFPay 提供的API凭证A6A49A******************5032
sign_typeString(256)是SHA256 or MD5, 建议SHA256sha256
signString(128)是请求签名以进行认证3b020a6349646684ebeeb0ec2cd3d1fb
paysourceString(12)是结尾必须是 _checkoutremotepay_checkout
txamtInt(11)是付款金额（单位：分）建议数值大于200，避免因支付金额过低而被交易风控。1099
txcurrcdString(3)是货币代码HKD
out_trade_noString(128)是唯一的外部交易号202005270001
txdtmString(32)是下单时间2020-06-24 20:04:37, Format: YYYY-MM-DD hh:mm:ss
return_urlString(256)是支付成功后的重定向URLhttps://xxx.com/return/success
failed_urlString(256)是支付失敗后的重定向URLhttps://xxx.com/return/failed
notify_urlString(256)是异步通知URLhttps://xxx.com/notify/success
mchntidString(16)否QFPay 代理商商户标识符PAKjVHJmQe
goods_nameString(64)是不能有特殊字符，不超过20个字母或汉字（需传入app支付参数）。 如果要在清算文件中显示商户名称，则该参数必须为空。
txzoneString(5)是时区该字段用于记录本地下单时间, 默认为北京时间 +0800.
udidString(40)是唯一設備ID0001
expired_timeString(3)是二维码过期时间单位为分钟，最短5分钟，最长120分钟，仅微信支付、支付宝、支付宝香港支持此参数
checkout_expired_timeString(3)是客户端过期时间单位为毫秒, e.g. 1715686118000，时间到了后，收银台页面会跳转至 支付失败后的重定向URL
limit_payString(3)是禁止使用信用卡参数值指定为no_credit，即禁止使用信用卡支付，仅微信支付支持此功能。
langString(5)是界面语言可能值
zh-hk (香港繁体中文)
zh-cn (简体中文)
en (英文)
如果结帐请求中不传递该参数，则结帐页面将使用浏览器的默认语言。 如果结帐请求中传递该参数，则生成签名时不包含该参数。
cancel_urlString(256)否按"返回到店铺"按钮的重定向URLhttps://xxx.com/return/checkout

创建新订单​

信息

每笔订单都是唯一的，因此商家在重定向到托管收银台页面时需要创建唯一的外部交易号“out_trade_no”。

创建新的结帐订单，必须发送带有身份验证签名的 GET 请求。 对于此签名，必须连接上述参数，然后使用 QFPay 提供的 app_key 进行哈希处理。 如需 API 凭证或技术支持，请联系 technical.support@qfpay.com。

右侧的示例说明了签名生成算法。 您还可以下载 QFPay Online Checkout Boilerplate 并在默认浏览器中打开 HTML。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>checkout</title>
    <style>

a{
  font-size: 20px;
}
    </style>
</head>
<body>
 <a id="standard">QFPay Online Checkout</a>

</body>
<script src="https://cdn.bootcss.com/blueimp-md5/2.10.0/js/md5.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/js-sha256/0.9.0/sha256.min.js"></script>

<script> 
window.onload = function(){
  let standard = document.getElementById('standard')

  let origin = 'https://test-openapi-hk.qfapi.com/checkstand/#/?'
   let obj = {
    appcode: "CC6FB660837E49F7A675D2**********",
    goods_name: "remotfpay_checkout_names",
    out_trade_no: "13322916216626239614",
    paysource: "remotepay_checkout",
    return_url: "https://www.baidu.com",
    failed_url: "https://www.baidu.com",
    notify_url: "https://www.baidu.com",
    sign_type: "sha256",
    txamt: "1",
    txcurrcd: "HKD",
    txdtm: "2020-06-28 18:33:20"
   }

   let api_key = "B3D4CCFD4AB049DCA82C25**********";
   let params = paramStringify(obj) 
   let sign = sha256(`${params}${api_key}`)
    standard.setAttribute('href', `${origin}${paramStringify(obj,true)}&sign=${sign}`)

}   

function paramStringify(json,flag) {
      let str = "";
      let keysArr = Object.keys(json);
      keysArr.sort().forEach(val => {
        if (!json[val]) return;
        str += `${val}=${flag ? encodeURIComponent(json[val]) : json[val]}&`;
      });
      return str.slice(0, -1);
    }

</script>
</html>