PayKKa OpenAPI Documentation
  1. 通信安全
PayKKa OpenAPI Documentation
  • 概述
  • 接口规则
  • SDK
  • 通信安全
    • 签名生成与验证
  • API列表
    • 商户入网
      • 商户入网申请
      • 商户资料更新
      • 商户入网结果查询
      • 商户入网结果(通知)
    • 收款账户
      • 收款账户开通申请
      • 收款账号开通申请结果查询
      • 收款账号开通结果(通知)
    • 汇入汇款
      • 汇入汇款(通知)
    • 订单
      • 订单创建
      • 订单更新
      • 订单状态查询
      • 补充物流(发货)信息
    • 解付入账
      • 创建解付入账流程
      • 解付入账状态查询
      • 解付入账结果(通知)
    • 账户余额
      • 查询账户余额
    • 收款人
      • 收款人创建
      • 修改收款人(用于被驳回时修改收款人信息)
      • 收款人创建结果查询
      • 收款人创建结果(通知)
    • 换汇
      • 换汇预下单(询价)
      • 换汇确认
      • 查询换汇结果
      • 换汇结果通知
    • 付款
      • 付款
      • 付款状态查询
      • 付款结果通知
    • 文件服务
      • 文件上传接口参数说明
      • 文件上传
  • 附录
    • 开通收款账户码表
    • 商品品类
    • 经营品类
    • 省市编码
    • 银行编码
    • 行业
    • 国家地区代码
  1. 通信安全

签名生成与验证

构造签名串#

签名串一共有五行,每一行为一个参数。结尾以\n (换行符,ASCII编码值为0x0A)结束,不包括最后一行。
注意:签名串的结构规则:每行一个元素,该行元素若是缺省不用传,但是换行符需要,保持结构不变。始终遵循一行一个元素,没有元素,还是得换行,最后一个元素除外
请求路径\n
请求时间戳(timestamp)\n
请求随机串(nonce)\n
商户号\n
请求报文主体
请求或响应不包含报文主体↓
请求路径\n
请求时间戳(timestamp)\n
请求随机串(nonce)\n
商户号
若请求的资源不涉及商户号, 则可以不用传,但是换行符还是需要(一个规则:每行一个元素,该行元素若是缺省不用传,但是换行符需要,保持结构不变。始终遵循一行一个元素,没有元素,还是得换行,最后一个元素除外)↓
请求路径\n
请求时间戳(timestamp)\n
请求随机串(nonce)\n
\n
请求报文主体
备注: 文件上传的报文主体与其他API不同, 需要特殊处理。文件上传参数说明
示例
tbc

计算签名值#

绝大多数编程语言提供的签名函数支持对签名数据进行签名。强烈建议客户调用该类函数,使用客户私钥对待签名串进行SHA256withRSA签名,并对签名结果进行Base64编码得到签名值。

设置HTTP头#

在所请求内容归属于商户的情况下, 需要设置X-Merch-Id请求头, 内容是 Paykka跨境收款开放平台 分配的商户号 (生成方式)
请求通过HTTPAuthorization头来传递签名, 其内容是一个经过URLEncode的JSON对象, 包含以下字段:
key格式说明
sign_typeString签名方式(SHA256_WITH_RSA)
timestampString请求生成时的毫秒时间戳值(Milliseconds since Unix Epoch)
nonceString(6-32)请求生成时, 随机生成的字符串, 用于请求防重
key_idString平台侧分配的密钥id, 对应客户
signatureString请求签名
修改于 2025-05-08 09:18:17
上一页
通信安全
下一页
API列表
Built with