请登录 免费注册

0571-28121986

流量功能 数趣数据支持HTTPS

该接口为流量充值功能,开发者在付啦开放后台充值个人财务后,可以调用此接口进行流量充值

数据ID:23 接口状态:正常 链接应用数:1 接入服务商:数趣数据

协议价

  • API
  • 响应码参照
  • 价格与请求限制
  • 示例代码
  • 其他相关
接口地址(线上环境):https//api.fulapay.com /flow/buy
支持格式:XML
请求方式:POST
请求示例:https://api.fulapay.com/flow/buy
RSA签名:

1. 待签名数据:将所有求参数(sign除外)按照字典升序排序后使用"&"把参数按照key=value形式拼接起来。

    举个例子:调用接口参数为service=fula.alipay.qrcode, app_id=1000000 那么待签名数据就是:app_id=1000000&service=fula.alipay.qrcode。

2. fula-pay-demo(Java)中使用商户私钥为pkcs8格式(demo中cert目录下有公私钥文件,开发者根据平台语言自行选择使用),线上环境如想直接使用demo中签名方法的请自行生成线上环境公私钥,生成并使用pkcs8格式的私钥,其他语言开发者请参考各语言RSA签名生成算法。

注意事项:

1)务必将请求头设置成text/html,否则付啦服务器读取不到请求参数。
2)非必填参数可以不传,如果传递了该参数并且其值为空,那么这个参数也要参与签名。

请求参数说明:
名称 类型 必填 说明
  charset string 字符编码 默认UTF-8 目前仅支持UTF-8
  service string 付啦交易查询接口名称 flow.buyflow
  app_id string 开发者在付啦开放平台管理后台(https://open.fulapay.com/login.html)创建的APP的ID
  mobile string 要充值流量的手机号
  flow_id string 要充值的流量商品号
  nonce_str string 随机数字
  sign_type string 签名方式 目前仅支持RSA
  sign string 请求参数按照字典升序排列后的RSA签名值 签名算法参照demo
  notify_url String 接收付啦支付结果异步通知的URL,需给绝对路径,255字符内格式 如:http://fulapay.com/notify.html,确保fula能通过互联网访问该地址
返回参数说明:
名称 类型 必填 说明
  charset string 字符编码 默认UTF-8 目前仅支持UTF-8
  service string 流量充值接口service
  app_id string 开发者在付啦开放平台管理后台(https://open.fulapay.com/login.html)创建的APP的ID
  order_id string 流量充值交易订单号
  res_code string 本次请求付啦响应码
  res_msg string 本次请求付啦响应信息
  sign string 请求参数按照字典升序排列后的RSA签名值 签名算法参照demo
  sign_type string 签名方式 目前仅支持RSA
  nonce_str string 随机字符串
XML请求示例:
                      <?xml version="1.0" encoding="UTF-8"?>
<xml>
    <app_id>1000015</app_id>
    <charset>UTF-8</charset>
    <flow_id>500000020</flow_id>
    <mobile>186581*****</mobile>
    <nonce_str>70b1e8ae531841778af23539c2b6436d</nonce_str>
    <service>flow.buy</service>
    <notify_url>url</notify_url>
    <sign_type>RSA</sign_type>
    <sign>ruX41LO0eriaczcDbBFdckN6iDRVXhCB+fs6OxLe+G5QYIn8a7xqTkProuzmvunXeLuFE4gIYFO191knxz
    evHNAcOkl9ztMqwt2OOSpZ12tul/aqDDiv+QxF8f7A/UglLwSqvl1k6iuFxSuapN0kE8r0CqVXlYIJol+o+4IJh9
    k=</sign>
</xml>

                  
XML返回示例:
                      <?xml version="1.0" encoding="UTF-8"?>
<xml>
    <app_id>1000015</app_id> 
    <charset>UTF-8</charset>
    <nonce_str>9mKQHQNce1xEluSFS7KFZIOTB6GI9BhL</nonce_str>
    <order_id>F1703081617220861306</order_id>
    <res_code>0000</res_code>
    <res_msg>请求成功:请求成功</res_msg>
    <service>flow.buy</service>
    <sign_type>RSA</sign_type>
    <version>1.0</version>
    <sign>mUxhPbLNIb2jxO0x48Fi/JAQqUQlz2YRj/MXPQQ9vu2Q9K1+JJugsAcWa/RK971Pl1Kav9RIYFnM
    XJ/1049DXlfMg6QvrB9YMQltY7GkfGd7wiXHEGAntWS5pLHZ1VNaDfydq7UiUNMOiDwrpGKNhJKhQUpID3
    +bxXfEfLvJMUo=</sign>
</xml>