签名机制

请求域名

收钱吧接入域名(api_domain):

  • 国内支付接入域名:https://vsi-api.shouqianba.com
  • 海外支付接入域名
    • 马来西亚:https://api.bayarlah.net

需要参与签名的接口及参数

需要使用服务商序列号(vendor_sn)和服务商密钥(vendor_key)进行签名的接口:

  • 1.激活接口(/terminal/activate)

需要使用激活得到的终端号(terminal_sn)和终端密钥(terminal_key)进行签名的接口:

  • 1.签到(/terminal/checkin)
  • 2.支付(/upay/v2/pay)
  • 3.预下单(/upay/v2/precreate)
  • 4.退款(/upay/v2/refund)
  • 5.撤单(/upay/v2/cancel)
  • 6.查询(/upay/v2/query)

    **注:如果使用了签到接口,请以签到返回的terminal_sn和terminal_key作为其他接口的签名参数**

签名方法

如果要正常使用各接口,需要按照以下方式去进行签名验证:

  • 支付平台所有的API仅支持JSON格式的请求调用,请务必在HTTP请求头中加入Content-Type: application/json
  • 所有请求的body都需采用UTF-8编码,所有响应也会采用相同编码。
  • 支付平台所有的API调用都需要签名验证。
  • 采用应用层签名机制。将HTTP请求body部分的UTF-8编码字节流视为被签名的内容,不关心主体的格式。
  • 签名序列号(sn)和签名值(sign)放在HTTP请求头中,在接入服务中统一校验。
  • 签名算法: sign = MD5( CONCAT( body + key ) )
  • 签名首部: Authorization: sn + " " + sign
  • 所有返回参数都为 JSON 格式,请务必在HTTP请求头中加入Content-Type: application/json。
  • 所有请求的body都需采用UTF-8编码,所有响应也会采用相同编码。
  • 所有返回数据的类型都是 字符串
  • 接口中所有涉及金额的地方都以 为单位。

    签名案例

    curl --request POST
    --url https://vsi-api.shouqianba.com/upay/v2/pay
    --header 'Authorization: sn+" "+sign' 
    --header 'content-type: application/json'
    --data '{"params": "test"}'
    

Demo程序代码

results matching ""

    No results matching ""