签名规则

签名算法说明

加密方式	SHA256WithRSA
密钥格式	PKCS8
签名算法	SHA256WithRSA后base64加密
公私钥长度	2048

密钥生成说明

商户需生成一对私钥和公钥，然后与Payjn交换公钥，请商户小心保管以防止泄露；

Payjn不接收商户私钥，请不要发送商户私钥给Payjn；

异步通知时使用Payjn公钥验签。

本平台提供的在线密钥生成工具：https://apitest.payjn.com/rsa-key-generator

签名步骤

将请求报文组成对象后转换成json string

拼接(使用&)接口地址

使用商户RSA私钥进行SHA256WithRSA签名

将签名获得的值放入http header中，key为sign

注意：json string 是http请求body，Payjn会原封不动进行验签。

创建代付订单签名示例

接口地址：${host}/api-pay/payout/order/create

假设传送的参数如下:

{
   "merchantCode": "258251",
   "amount": 30000.00,
   "countryCode": "IDN",
   "merchantOrderId": "P20250203850899",
   "bankCode": "DANA",
   "bankAccountNo": "081234567890",
   "merchantNotifyUrl": "http://merchant-api.com/callback",
   "customer": {
      "name": "Clinton Alisa",
      "email": "clintonAlisa@gmail.com",
      "phone": "08126788314"
   }
}

签名明文：

{
  "merchantCode": "258251",
  "amount": 30000.00,
  "countryCode": "IDN",
  "merchantOrderId": "P20250203850899",
  "bankCode": "DANA",
  "bankAccountNo": "081234567890",
  "merchantNotifyUrl": "http://merchant-api.com/callback",
  "customer": {
    "name": "Clinton Alisa",
    "email": "clintonAlisa@gmail.com",
    "phone": "08126788314"
  }
}&/api-pay/payout/order/create

带签名报文：

Demo

Java

Python

Golang

注意事项

签名必须使用商户私钥，验签使用Payjn公钥

签名值必须进行base64编码

签名必须放在HTTP header中，key为sign

签名原文必须严格按照规则拼接

请妥善保管私钥，不要泄露给任何第三方

签名算法说明#

密钥生成说明#

签名步骤#

创建代付订单签名示例#

Demo#

Java#

Python#

Golang#

注意事项#