Paycools Partner API Docs
Languages
Languages
  • 中文
  • English
Languages
Languages
  • 中文
  • English
    • 统一 API请求参数
    • 统一异步通知参数
    • API通用提示码
    • 1. 商户进件
      • KYC信息枚举
      • KYC银行列表
      • 1.1 商户注册
        POST
      • 1.2 提交KYC信息
        POST
      • 1.3 商户信息查询
        POST
      • 1.4 文件上传-文件版本
        POST
      • 1.5 商户授权状态查询
        POST
      • 1.6 商户KYC状态变更通知
        POST
      • 1.7 重新提交 KYC 信息
        POST
    • 2. 账号查询
      • 国家编码列表
      • 2.1 余额查询
        POST
      • 2.2 对账文件下载
        POST
    • 3. 收款
      • 支付 ChannelCode列表
      • 3.1 收款下单接口
        POST
      • 3.2 收款状态查询接口
        POST
      • 3.3 收款回调通知
        POST
    • 4. 收银台
      • 支付 ChannelCode列表
      • 4.1 收银台下单接口
        POST
      • 4.5 收款回调通知
        POST
      • 4.2 收银台查询接口
        POST
      • 4.3 收银台订单获取可用渠道接口
        POST
      • 4.4 收银台订单关闭接口
        POST
    • 5. 退款
      • 退款支持列表
      • 退款状态枚举
      • 5.1 退款接口
      • 5.2 退款查询接口
      • 5.3 退款回调接口
    • 6. 分账
      • 分账相关枚举
      • 6.1 关系证明文件上传
      • 6.2 添加分账接收方
      • 6.3 查询分账接收方
      • 6.4 删除分账接收方
      • 6.5 查询待分账金额
      • 6.6 请求分账
      • 6.7 查询分账结果
      • 6.8 请求分账退回
      • 6.9 查询分账退回
    • 7. 授权代扣
      • 授权代扣渠道列表
      • 7.1 发起代扣授权
      • 7.2 查询代扣授权状态
      • 7.3 取消代扣授权
      • 7.4 代扣授权状态通知

    统一异步通知参数

    内容#

    参数名是否必填类型说明
    sign是stringparam 的RSA签名
    param是string请求参数字符串

    示例#

    {
      "sign": "abcdef",
      "param": "{}"
    }

    说明#

    1.
    Platform 会根据具体接口文档,构造请求参数,将请求参数格式化为 JSON 格式,作为 param 的值;
    2.
    Platform 使用 Platform 的 RSA 私钥对 param 进行签名,得到的值作为 sign 的值;
    3.
    商户在收到 Platform 的请求时,使用 Platform 的 RSA 公钥对 param 进行验证签名,如果签名与 sign 一致,则证明该请求是由 Platform 请求的;
    4.
    Platform 的 RSA 公钥请向 Platform 管理员索取。

    附录 RSA 使用示例(Java 语言)#

    生成RSA密钥对:
    RSA 公钥请提交给 Platform,请不要透露给任何第三方。
    RSA 私钥由商户保管,请不要透露给任何人。
    当商户请求 Platform 的 Open API 时,商户使用 RSA 私钥对请求参数进行签名,Platform 会使用商户提供的 RSA 公钥对请求中的签名进行验证。如果验证失败,Platform 服务器会拒绝处理请求。

    示例密钥对#

    RSA 公钥:
    MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAna4Dyz8nGJiAlc9jTGyRa+TtlZXYABTc+Xfb3T4NdDbnUO8vtNLHugwmqARp8kzEzsMRbmvKro4EpaXqANn7SAGo+YI6sVUDmX7ESk3P6j51PtTvWR6dikJN6qwtmV64ojEbxDnIBL3VKuctefL8uPcI7MZBUPBXg9l8CZmnn2cKqWjZ8MuEQr4G45IqmJ0tRsRmW9ofNnvI1MLPt7c/Z/D1E6HKVwjPcMZKMuF0HpIDqdQaPX83dlSzv9FF9jFR8HWfWW8Oz3jz+GtSLSdh2ERcyO56WHpWl1POV4o9jF+4R/oBgcH+0zA1Z2aFfQf/n9miMhacrioStBaHkh1f/QIDAQAB
    RSA 私钥:
    MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCdrgPLPycYmICVz2NMbJFr5O2VldgAFNz5d9vdPg10NudQ7y+00se6DCaoBGnyTMTOwxFua8qujgSlpeoA2ftIAaj5gjqxVQOZfsRKTc/qPnU+1O9ZHp2KQk3qrC2ZXriiMRvEOcgEvdUq5y158vy49wjsxkFQ8FeD2XwJmaefZwqpaNnwy4RCvgbjkiqYnS1GxGZb2h82e8jUws+3tz9n8PUTocpXCM9wxkoy4XQekgOp1Bo9fzd2VLO/0UX2MVHwdZ9Zbw7PePP4a1ItJ2HYRFzI7npYelaXU85Xij2MX7hH+gGBwf7TMDVnZoV9B/+f2aIyFpyuKhK0FoeSHV/9AgMBAAECggEAYyqq5iucqgJXdGCO4eSx/LpolZg81ahJZXf1RgqdqYZSKnuTdFTQGflEYo0MGMAhUqwqDVkrimZ1E7zqE4kEWT/6BpnZ0edWsTWhu91+MqL/V/nRYio4CFk06a9JqliBJDhgbyOr4ReGtknYNwcT3Dw5V7hEIeRWFe007lC9tCi7mlpzBNwEIf4itmnncuA70GlxcoMkoGzfYg79eUCfXorbfJcaamR2wXLSU6KoJ422UR3L0rgzmgXzVQw9rrlQ3h6viDykKfaPi/43MN2qb6Zu5isbJIzyz0kHrcE6KJMgJhBDkLIo0f0qE/rEl1Xp/qDwr4+3WBfCHeuTFsud/QKBgQDXmA3f0/ONPMgEGdJlwG20W+7jXHabnRPuUJyDQKbtP+vuaKrpzN+jC1rlxBfAJj2iAVXXXM/RFWWapBd16TqGI4P3RW8eocaxhyl8rWSvCOy/OueNI+fM8gX/IjsJc7VMmCEWHuLvXoM2ixXPWP3v0DEPPPDrCd5dnjR6+5oGgwKBgQC7O03ps4KzMUzEtJcrFFKV0C/m1X905OqQ3cKQnGqRzLp/7d9DQsv+oKzjlpz1xktdJmig7ABiL0+FqJHdcrNiVabI5c6oS2SZkToQFlKv2GYT2KikJ0L43xLfiDvB3tues//9OXuU0WzXZqq7CNAvcmAdPjlFi9RxHsRGABo3fwKBgEi2EJ/XpQGSaUbwyoPktVsp0lS9/4aWIH20lES0DlhfwZuDk3kMzrP3hW2OiBAXFZxI5QGgXLqAg+b2xq7OvR02ZzCDK2niV9fR5Q0Wkaly0h3gqO1yGaCGU71rdwvGCXROroH+Yr0mXAyONgnbUrGJvrIL9JjgmC1syPhdWOIvAoGBAJHJbbNpWX3aB2KrE4IxwtRwVLwyxZnpnVPLuPINOVXpydZPDCc9XcYYqkZUQkeFba1MeO/Ek8/f8tWqGloKM+9/reyENFQK0Hxa/pEEMMJHh8QwUa/v+k/6sqFnXNBqjSuYEN3F4ppQL6XRhWM5S5GGR5y9lK64YGTshfvTnJZVAoGBAJ3TmJcRJWfi7CA985VAnE+IQoQfKKz9NTT7hGBwWTVd7iUc0QCpgHNIixZnfVcjKxz7Hhq6Vy+cEbDBtwbSuDfuVf1spiiqOuYVIjFqq5AsuvpX1CJmm7V+LRtJO/NXmXQP5YfojzET9NqTZvGEVXuzPA0qp8JC7HKrCYykscqE

    RSA 签名:#

    sign 的值:
    PLw6eHk/7uDxxzhvLIUIunEeUcOTKHXqrLjTZgTUEfNv2br8xV9hGqd8YHcKKkgfoHYkI//VGeKDpQAMNwDAAiDcupJLI45bkB1sGd5evg9A1IguT2effam/wWIz8nPCsMxsoG2N+eVtm+kRJ4anL/A0nj3Z6PzPipUsff9K31KATGmiMvBiRSa977MdLgmyoTXPj0wxbZNDVqsWzSQowYb8h7/7fPQ62rBmsQTsf3TR80FQXTtKx0xhV88I0xGFQlNUcKv+HgqIEAunlQr2PoXjply4wlNwZLEeaAdMC+3gFgItj8yzLwJ1hlJEB8cCYuFtrH6wo/7C7S+7oxHHsQ==

    RSA 签名验证#

    result 的值: true
    上一页
    统一 API请求参数
    下一页
    API通用提示码
    Built with