雪球2.0-开放接口
    雪球2.0-开放接口
    • 雪球收单平台-开放接口对接文档
    • 修改终端服务费
      POST

    雪球收单平台-开放接口对接文档

    雪球收单平台-开放接口对接文档#

    版本 V1.0#

    版本原因作者日期
    1.0完成整体化文档王翊洲2023-12-26

    第一章 接口规则#

    1.1 数据格式#

    报文域(key)属性值 (value)备注
    timestamp时间戳milliseconds，示例：1703574468000，30s 过期，参与签名
    accessKeyIdaccessKeyId系统分配，参与签名
    accessKeySecretaccessKeySecret系统分配，参与签名
    encryptedData加密后的请求/应答报文公钥加密(RSA/ECB/PKCS1Padding)，加密结果采用 base64 编码
    encryptedKey加密后的 AES 秘钥AES 加密(AES/ECB/PKCS5Padding)，加密结果采用 base64 编码
    sign签名对 encryptData 对应的明文进行签名(SHA1WithRSA)，签名结果采用 base64 编码
    返回信息:#
    报文域(key)属性值 (value)备注
    success请求是否成功true成功，false失败
    message返回消息
    code返回值只有200是成功请求
    timestamp时间戳当前时间戳

    1.2 HTTP 请求协议头定义#

    http 请求头定义主要是用于合作方服务器与我司服务器交易的请求协议定义，双方采用约定的 json 数据格式交互。
    json 格式请求：
    Content-Type：application/json;charset=utf-8
    json 格式返回：
    Accept：application/json;charset=utf-8

    1.3 请求示例#

    curl 
--location 
--request POST '/snowball-v2/openApi/editMerchantRate'
--header 'Accept-Charset: utf-8'
--header 'Content-Type: application/json'
--data-raw '{
        "timestamp": "1703663195066",
        "accessKeyId": "1",
        "accessKeySecret": "2",
        "encryptedData": "wR4SVqIRNFg+jVnyYk/kZJD3PnekN5a1WfhVFNM8c6AOBlTIN3doM2bJJxEXt7FqUIzrxkir9QRXAvwhOSi3FPNjui8rIIYfoQ3bzsP/2RhYg2XWIn2souHImw6GOkG6",<br/>
        "encryptedKey": "dGdQo65eBLgwkqCmhH/I2hqWzL7n6qWLxrzDynM3irLsV3kpOvSDIUWmT7b3Ze/VoyLq4MtNsaOoI1SEO9NgSuwdu79cp5xlTV0+AdeoPPe7s++pw0gFeZttJTQeJ1QTXEHEl77vJwJlsz4JPRtZuQelcIOi9ZjR7MJyY/pCRYope/c6cY6RA9a7h4b0pwblPaRlYuMEhxeWCtT7ejLDj4a+c+fLZBUZ2Nj4k/pyrTcT/mRSrt+vwWE2QI14eYAhATYZzD/acIMlmqFe3yYZTf3+tE3lhnnb8JFjvOcXOgIR1fWkY0lwLd9hcL2fYi1LAUekoiEaK9EzOl3rOlOF6g==",
        "sign": "UX+knhcMp7lbw8NWX/rU8ilhi/+Nsw83OerGJ9BvFxNi3LvlOWauvPJ+Cjr6yNrSp8ohg60MOe8oZT2GhYF2AYbXje705wGbdccMLVd+EGqDTDxu9/qL5c2uY2AUCDI3zmt6afxK+2jr3ZYCgtPpUvlcZRO2n1F8kmKa3gQiSoCfuT9LOSx3TYqNI7Om+N/OQYW5PAzgqtGYfWcQ0jhoa33d32cnuHOsnEZRqReoIO4OmYV/k95LHJHPvX/qGY0xAKc4Rs9W5K4BmHoXQPtskhuOKrywJhfiRKnubi8pjnx7DyFfm6Ho+QB7iJN+nI+zHSemq8kCn9sfLl2pMzS1VA=="
    }'

    1.4 返回示例#

    {
    "success": false,
    "message": "[雪球收单平台-开放接口],终端未找到",
    "code": 500,
    "timestamp": 1703663203439
}

    1.5 安全机制#

    1、encryptData：合作方构造请求报文头，对业务数据字段明文进行加密操作，AESKey 为随机生成的 16 位字符串+数字，进行 AES 加密。
    AES 加密算法为：AES/ECB/PKCS5Padding
    2、sign: 数字签名，合作方使用私钥对业务数据字段明文进行数字签名。
    签名算法为：SHA1WithRSA
    3、encryptKey: 加密后的 AES 秘钥，合作方使用平台公钥对随机生成的 AES 秘钥进行 RSA 加密。秘钥长度为：2048，padding 填充字节数：11。
    加解密算法为：RSA/ECB/PKCS1Padding

    第二章 接口列表#

    2.1 修改终端服务费#

    请求地址：/snowball-v2/openApi/editTerminalServiceFee
    注：所有金额相关单位为元，保留两位小数；费率相关保留六位小数。
    字段类型长度说明
    tusn字符串50终端tusn
    serviceFee数值型16,2服务费金额

    2.2 修改终端费率#

    请求地址：/snowball-v2/openApi/editTerminalRate
    注：所有金额相关单位为元，保留两位小数；费率相关保留六位小数。
    字段类型长度说明
    tusn字符串50终端tusn
    preferentialSettlementRate数值型16,6特惠结算费率
    debitCardSettlementRate数值型16,6借记卡结算费率
    debitCardSettlementFee数值型16,2借记卡封顶成本
    creditCardSettlementRate数值型16,6贷记卡结算费率
    scanCodeSettlementRate数值型16,6扫码结算费率
    transactionSecondSettlementFee数值型16,2快提成本

    2.3 修改商户费率#

    请求地址：/snowball-v2/openApi/editMerchantRate
    注：所有金额相关单位为元，保留两位小数；费率相关保留六位小数。
    字段类型长度说明
    tusn字符串50终端tusn
    preferentialSettlementRate数值型16,6特惠结算费率
    debitCardSettlementRate数值型16,6借记卡结算费率
    debitCardSettlementFee数值型16,2借记卡封顶成本
    creditCardSettlementRate数值型16,6贷记卡结算费率
    scanCodeSettlementRate数值型16,6扫码结算费率
    transactionSecondSettlementFee数值型16,2快提成本
    修改于 2023-12-28 09:53:39
    下一页
    修改终端服务费
    Built with