1.文档说明

1.1文档目的

本文档是交易集中入口的说明文档。本文档主要介绍入口参数公共参数部分。具体业务部分的参数，参见具体的接口文档说明。
接口入口参数=公共参数+业务服务参数

1.2阅读对象

• 接口对接开发人员、维护人员和管理人员

1.3技术支持

在开发或使用接口文档时，如果您有任何技术上的疑问，请按如下方式寻求帮助，宝付技术支持人员会及时处理，给予您答复：
技术支持热线：021-68819999
技术支持Email：support@baofu.com
技术支持QQ：800066689

1.4术语与定义

1.4.1符号含义

1.4.2术语含义

• 商户号：宝付提供给商户的唯一编号，是商户在宝付的唯一标识；
• 终端号：商户在与宝付签订某项具体产品功能的合作协议自动分配的会员属性，将用于进行具体交易的必要参数。

2.统一入口说明

2.1 请求地址

• 测试环境地址：https://vgw.baofoo.com/union-gw/api/{服务编号}/transReq.do
• 正式环境地址：https://public.baofu.com/union-gw/api/{服务编号}/transReq.do

提交方式：POST

2.1.1 URL参数

大致格式如下：

https://vgw.baofoo.com/union-gw/api/{服务编号}/transReq.do?memberId=%memberId&terminalId=%terminalId&verifyType=verifyType&content=%content&veryfyString=%veryfyString

2.2 请求报文

请求参数

verifyType传值说明：

content说明
1.格式：JSON
2.组成：由header和body两部分组成
3.明文示例:

{
    "body": {
        "amount": 1.00,
        "cardName": "zhangsan",
        "cardNo": "123"
    },
    "header": {
        "memberId": "001",
        "serviceTp": "T-1001-001-01",
        "terminalId": "002",
        "verifyType": "1"
    }
}

header部分

body部分

参考具体业务接口的请求报文参数

2.3 同步响应报文

响应内容格式依赖于加密方式verifyType，具体如下

verifyType=1时密文解密后的数据示例

{
    "body": {
        "accountType": "BASE_ACCOUNT",
        "balance": 33275.94,
        "retCode": 1
    },
    "header": {
        "memberId": "100024469",
        "serviceTp": "T-1001-006-03",
        "sysRespCode": "S_0000",
        "sysRespDesc": "",
        "terminalId": "200000994"
    }
}

header部分

body部分

参考具体业务接口的返回报文参数

附录：

1.系统响应吗

注意：

• 此响应码仅代表系统请求的一个到达情况，不作为业务处理的结果标识。
• 具体业务处理响应，需要根据body中具体的相关状态标识判断。

2.报文编号

报文规则
采用“T-XXXX-YY-NN”定义报文编号
T位固定位
XXXX 用来区分不同业务的报文
YY 为预留位
NN 为报文版本号信息