文档名称

文档说明：

  • 本文档用于发票的接口描述

文档版本：

版本号 制定人 制定日期 修订日期
1.0 杨铝杰 2019-12-09 2019-12-09

测试帐户:

测试帐号联系业务经理。

场景介绍:

主要用于接口开票。包括POS机上的开发票和第三方开发票。

案例介绍:

无

流程说明:

无

接口说明:

请求URL:
请求方式：
  • POST
请求头：
参数名 是否必须 类型 说明
Content-Type 是 string 请求类型： text/xml
请求参数:
字段名 变量名 是否必须 类型 说明
接口类型 service 是 String(32) xrtpay.invoice
版本号 version 否 String(8) 默认值是 1.0
字符集 charset 否 String(8) 可选值 UTF-8，默认为 UTF-8
签名方式 sign_type 否 String(8) 取值：MD5 默认： MD5
平台订单号 transaction_id 是 string 平台订单号
订单金额 total_fee 是 int 订单金额，单位为分
商户号 mch_id 是 string 商户号,POS机商户号或者接口方商户号
随机字符串 nonce_str 是 string 随机字符串
签名 sign 是 String(32) MD5 签名结果， 详见“ 下文数字签名 MD5 签名规则”
请求参数示例:
<xml>
       <service>xrtpay.invoice</service>
       <version>1.0</version>
       <charset>UTF-8</charset>
       <sign_type>MD5</sign_type>
       <transaction_id>20191209346789999784</transaction_id>
       <total_fee>50000</total_fee>
       <mch_id>86144034567890</mch_id>
       <nonce_str>2hdi89dnfd</nonce_str>
       <sign>ABDHJDUDIDDID89DJk</sign>
<xml>
返回示例:

正确时返回:

<xml>
    <charset>UTF-8</charset>
    <err_code>000000</err_code>
    <err_msg>发票二维码生成成功</err_msg>
    <mch_id>861440354111560</mch_id>
    <nonce_str>ed081246f5453594</nonce_str>
    <result_code>0</result_code>
    <sign>93A8C59E5DF0D6E849321F0657509B6D</sign>
    <status>0</status>
    <code_url>https://fp.xrtpay.cn/token/234jdkdkdk</code_url>
    <version>1.0</version>
</xml>

错误时返回:

<charset>UTF-8</charset>
    <err_code>000001</err_code>
    <err_msg>发票生成不成功</err_msg>
    <mch_id>861440354111560</mch_id>
    <nonce_str>ed081246f5453594</nonce_str>
    <result_code>0</result_code>
    <sign>93A8C59E5DF0D6E849321F0657509B6D</sign>
    <status>0</status>
    <version>1.0</version>
返回参数说明:

问题排查:

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2021-03-06 11:16   作者：EricYang