EasyPayment
    EasyPayment
    • 签名与验证签名
    • 系统错误码枚举值
    • 相关场景问题与解决方案
      • 美元代收代付常见问题
    • 代收接口
      • 创建代收订单
        POST
      • 银行卡支付
        POST
      • 查询代收订单
        POST
      • 代收结果通知
        POST
      • 代收订单补单
        POST
    • 代付接口
      • 创建代付订单
        POST
      • 查询代付订单
        POST
      • 代付结果通知
        POST
      • 查询账号余额
        POST
    • 代付配置参数 - PayConfig
      • 印度 - INR
        POST
      • 菲律宾 - PHP
        POST
      • 巴西雷亚尔 - BRL
        POST
      • 印尼盾 - IDR
        POST
      • 墨西哥 - MXN
        POST
      • 秘鲁 - PEN
        POST
      • 哥伦比亚 - COP
        POST
      • 越南 - VND
        POST
      • 美国 - USD
        POST
      • 泰国 - THB
        POST
    • Schemas
      • CurType
      • PayinOrderStatus
      • PayoutOrderStatus
      • Language

    签名与验证签名

    请求参数签名#

    注意,参数请进行动态排序签名。切勿写死顺序进行签名请求。
    如果签名失败可以根据接口返回的 signStr 字段进行自行排查问题
    下列内容会被判断为空
    "" (空字符串)
    0 (作为整数的0)
    0.0 (作为浮点数的0)
    "0" (作为字符串的0)
    [] (一个空数组)
    1.
    筛选
    获取所有请求参数,不包括字节类型参数,如文件、字节流,剔除sign与sign_type参数和value为空的参数。
    2.
    排序
    将筛选的参数按照第一个字符的键值ASCII码递增排序(字母升序排序),如果遇到相同字符则按照第二个字符的键值ASCII码递增排序,以此类推。
    3.
    拼接
    将排序后的参数与其对应值,组合成“参数=参数值”的格式,并且把这些参数用&字符连接起来,此时生成的字符串为待签名字符串。MD5签名的商户需要将key的值拼接在字符串后面,调用MD5算法生成sign

    返回参数验证签名#

    1.
    筛选
    获取所有请求参数,不包括字节类型参数,如文件、字节流,剔除sign与sign_type参数和value为空的参数。
    2.
    排序
    将筛选的参数按照第一个字符的键值ASCII码递增排序(字母升序排序),如果遇到相同字符则按照第二个字符的键值ASCII码递增排序,以此类推。
    3.
    拼接
    将排序后的参数与其对应值,组合成“参数=参数值”的格式,并且把这些参数用&字符连接起来,此时生成的字符串为待签名字符串。MD5签名的商户需要将key的值拼接在字符串后面,调用MD5算法生成sign

    签名拼接过程例子#

    1、请求参数
    {
        "uid": 1065,
        "out_trade_no": "string",
        "trade_no": "string",
        "product_name": "string",
        "order_status": 0,
        "third_trade_utr": "string",
        "money": "string",
        "sign": "string",
        "sign_type": "string"
    }
    2、参数根据字母升序排序 过滤剔除sign与sign_type参数和value为空的参数
    ^ array:7 [
      "money" => "string"
      "out_trade_no" => "string"
      "product_name" => "string"
      "third_trade_utr" => "string"
      "trade_no" => "string"
      "uid" => 1065
    ]
    3、拼接签名API KEY 注意无需带上{}符号
    money=string&out_trade_no=string&product_name=string&third_trade_utr=string&trade_no=string&uid=1065{签名key}
    Modified at 2025-10-24 08:55:53
    Next
    系统错误码枚举值
    Built with