@931876502 2016-05-26T08:09:59.000000Z 字数 14588 阅读 930

alipay-f2f 接口api文档

alipay-f2f

版本号:1.1.1=>1.2.1

部门:研发部

岗位:服务端开发人员

姓名:杨松

建立日期:2016-3-22

更新日期:2016-5-17 16：42

POSTMAN 测试接口：`https://www.getpostman.com/collections/5515a900ec118fa56d52`

alipay-f2f流程图：

名称	图片链接地址
注册公司门店流程图	http://7xsfv8.com2.z0.glb.qiniucdn.com/alipay-f2f-projectImg-reg_com.png
更新公司流程图	http://7xsfv8.com2.z0.glb.qiniucdn.com/alipay-f2f-projectImg-update_com.png
查询公司门店流程图	http://7xsfv8.com2.z0.glb.qiniucdn.com/alipay-f2f-projectImg-query_store.png
心跳测试流程图	http://7xsfv8.com2.z0.glb.qiniucdn.com/alipay-f2f-projectImg-heart_beat.png
条码支付流程图	http://7xsfv8.com2.z0.glb.qiniucdn.com/alipay-f2f-projectImg-barcode_trade_pay.png
二维码扫码支付流程图	http://7xsfv8.com2.z0.glb.qiniucdn.com/alipay-f2f-projectImg-qrcode_trade_pay.png
查询订单流程图	http://7xsfv8.com2.z0.glb.qiniucdn.com/alipay-f2f-projectImg-query_order.png
退款流程图	http://7xsfv8.com2.z0.glb.qiniucdn.com/alipay-f2f-projectImg-refund.png

DOMAIN 主机域名定义 env

v1.0.0

TEST =

DEVE = http://alipay-f2f.dev.dlhis.com

PREPRO =http://f2f.alipay.dlhis.com

PRODUCTION

v1.2.1

TEST =

DEVE = http://f2fv2.dev.dlhis.com

PREPRO =http://f2fv2.alipay.dlhis.com

PRODUCTION

API.AH01生成secretKey接口 `1.2.1`

URL：/auth/secret
input：dogNo=

B996377230C16FEF1BA98F127C1A4570

示例:

{{ALIPAYF2F}}/auth/secret?dogNo=B996377230C16FEF1BA98F127C1A4570

参数说明
1. dogNo：加密狗号
  - 必填,用于生成secetKey
返回值
- 返回值类型：json
- 返回值结构：
  - 成功结果：

{
  "data": {
    "dogNo": "B996377230C16FEF1BA98F127C1A4570",
    "secretKey": "2a99b6c4956d7990367aebc666e120a3",
    "skId": 1
  },
  "err": "nothing",
  "msg": "success",
  "re": {},
  "reErr": {},
  "statusNo": 200,
  "version": "1.2.1"
}

- - 失败结果(以加密狗号长度不符32位为例)

{
  "data": {},
  "err": "DOGNO_LENGTH_IS_ERROR",
  "msg": "加密狗号长度为32位!!",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.2.1"
}

- 返回值说明：
  - 参数：
    1. dogNo：用户申请secretKey的加密狗号dogNo
    2. secretKey：用户申请的密钥
    3. skId: 序列号(暂未用到)

API.AH02获取访问令牌token接口 `1.2.1`

URL：/auth/token

input：dogNo=B996377230C16FEF1BA98F127C1A4570&secretKey=82de52b5a1fe740e865f52b5d5d1ff86

示例:

{{ALIPAYF2F}}/auth/token?dogNo=B996377230C16FEF1BA98F127C1A4570&secretKey=d339a12def4a3c1073ed2aeda92b1c64

参数说明
1. dogNo：加密狗号
  - 必填
2. secretKey：用户之前申请的密钥
  - 必填
返回值
- 返回值类型：json
- 返回值结构：
  - 成功结果：

{
  "data": {
    "ahId": 1,
    "dogNo": "B996377230C16FEF1BA98F127C1A4570",
    "endTime": "2016-05-11 12:30:51",
    "token": "985cf8a87e129d25d7b7c49d2422eb72"
  },
  "err": "nothing",
  "msg": "success",
  "re": {},
  "reErr": {},
  "statusNo": 200,
  "version": "1.2.1"
}

- - 失败结果(以加密狗号与密钥不符为例)

{
  "data": {},
  "err": "DOGNO_IS_NOT_MATCH_SECRETKEY",
  "msg": "加密狗号与密钥不匹配!",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.2.1"
}

- 返回值说明：
  - 参数：
    1. dogNo：用户的加密狗号dogNo
    2. token：用户申请到的访问令牌
    3. endTime：访问令牌有效截止时间
    4. ahId: 序列号(暂未用到)

API.CP01录入酒店信息接口 `1.2.1`

URL：/f2f/company/add?data=
input：data=

{"storeDogNo":"DL00066","cpiPid":"2088212612254566","cpiAppid":"2016022901171807"}&token=014287cdec233f366118a6eb4df51ce8

示例:

{{ALIPAYF2F}}/f2f/company/add?data={"storeDogNo":"DL001118","cpiPid":"2088212612254111","cpiAppid":"2016022901171807"}&token=3a898544c65b8fc6f8fe62bbebd5d072

参数说明
1. storeDogNo：门店加密狗号
  - 必填，来自调用方输入
2. cpiPid：合作伙伴PID
  - 必填，来自阿里商家后台（3.合作伙伴密钥部分）
3. cpiAppid：APPID
  - 必填，来自阿里商家后台（查看APPID和密钥设置部分）
4. token：访问令牌 1.2.1
  - 必填，来自授权认证获取的访问令牌token
返回值
return
- 返回值类型：json
- 返回值结构：
  - 成功结果：

{
  "data": {
    "cpiId": 1,
    "cpiType": "f2f",
    "storeNo": "006",
    "cpiAppid": "2016022901171807",
    "cpiPid": "2088212612254566",
    "cpiPubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDs/2Ia7xNHx+6laa/nB1xQWxi7OsTHQqOMa7KRavVdu2z6yjRUKkx91sQhhr3fcooE1TlxDH+fgr9LbtBh2yxWs4g0+yU7nF4xzOpkZjLUVf2W/XaNJ+e3Sf0GoARyKEjgocKaNyiFuEdjUBy/MoGVI69WVlkt/X3QeeYzf9+pFQIDAQAB",
    "createTime": 1459150408985,
    "cpiPriKey": "如果需要请联系工作人员！",
    "storeDogNo": "DL00066",
    "cpiNo": "DL20160328000001",
    "cpiAlipubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDI6d306Q8fIfCOaTXyiUeJHkrIvYISRcc73s3vF1ZT7XN8RNPwJxo8pWaJMmvyTn9N4HQ632qJBVHf8sxHi"
  },
  "err": "nothing",
  "msg": "success",
  "re": {},
  "reErr": {},
  "statusNo": 200,
  "version": "1.0.1"
}

- 失败结果（以该公司已经存在为例）

{
  "data": {},
  "err": "DOGNO_ALREADY_EXISTS",
  "msg": "该加密狗号已经被使用！",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.0.1"
}

- 失败结果（以token无效为例）1.2.1

{
  "data": {},
  "err": "TOKEN_IS_INVALID",
  "msg": "访问令牌无效!请重新获取访问令牌!",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.2.1"
}

- 返回值说明：
  - 返回值说明：
  - 参数：
    1. msg：请求结果信息
    2. statusNo：请求状态码
    3. data：返回生成记录
      - cpiId：公司ID
      - cpiNo：公司编号（唯一标识）
      - cpiType：公司类型
      - storeNo：门店编号
      - cpiAppid：APPID
      - cpiPid：合作伙伴PID
      - cpiPubKey：用户公钥
      - storeDogNo：该门店加密狗号
      - cpiAlipubKey 阿里支付宝公钥

API.CP02查询酒店信息接口 `1.2.1`

URL：/f2f/company/query
input：data=

{"cpiNo":"DL20160328000001","storeNo":"001"}&token=014287cdec233f366118a6eb4df51ce8
或者：
{"storeDogNo":"DL0001"}&token=014287cdec233f366118a6eb4df51ce8

示例:

{{ALPF2FHOST}}/f2f/company/query?data={"cpiNo":"DL20160328000003","storeNo":"001"}&token=3a898544c65b8fc6f8fe62bbebd5d072

参数说明（参数1,2可以作为查询条件，参数3可以单独作为查询条件，不能同时为空，参数3优先使用）
1. cpiNo：酒店编号
  - 调用方注册时酒店编号
2. storeNo：门店编号
  - 调用方注册时门店编号
3. storeDogNo：加密狗号
  - 调用方注册时加密狗号
4. token：访问令牌 1.2.1
  - 必填，来自授权认证获取的访问令牌token
返回值
- 返回值类型：json
- 返回值结构：
  - 成功结果：

{
  "data": {
    "cpiId": 1,
    "cpiType": "f2f",
    "storeNo": "001",
    "cpiAppid": "2016032501241041",
    "cpiPid": "2088121307572082",
    "cpiPubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDFJBf36pmn+Q0MD4JWoIVLzGw7cdurOn3Hp0x1CnpMKyJHZLRRtz419LvTmOelrIuevklHLLZfkzkt14alDwuHxqqO+fS24mBYqdVcFtAQhN2H5fy0mbl32mIQ3OpyWZGGzPOpR6aHknDbVj2hNqW5S84KddQnWVN/9ZB101CWnQIDAQAB",
    "createTime": "2016-03-28 20:20:00",
    "cpiPriKey": "如果需要请联系工作人员！",
    "storeDogNo": "DL0001",
    "cpiNo": "DL20160328000002",
    "cpiAlipubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDI6d306Q8fIfCOaTXyiUeJHkrIvYISRcc73s3vF1ZT7XN8RNPwJxo8pWaJMmvyTn9N4HQ632qJBVHf8sxHi/fEsraprwCtzvzQETrNRwVxLO5jVmRGi60j8Ue1efIlzPXV9je9mkjzOmdssymZkh2QhUrCmZYI/FCEa3/cNMW0QIDAQAB"
  },
  "err": "nothing",
  "msg": "success",
  "re": {},
  "reErr": {},
  "statusNo": 200,
  "version": "1.1.1"
}

- - 失败结果（以该公司门店不存在为例）

{
  "data": {},
  "err": "RESULT_NOT_EXISTS",
  "msg": "查询结果不存在，请检查参数！",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.1.1"
}

- - 失败结果（以token无效为例）1.2.1

{
  "data": {},
  "err": "TOKEN_IS_INVALID",
  "msg": "访问令牌无效!请重新获取访问令牌!",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.2.1"
}

- 返回值说明：
  - 返回值说明：
  - 参数：
    - msg：请求结果信息
    - statusNo：请求状态码
    - data
      1. storeNo：门店编号
      2. storeDogNo：门店加密狗号
      3. cpiAppid：APPID
      4. cpiId：酒店序号
      5. cpiNo：酒店编号
      6. cpiPid：合作伙伴PID
      7. cpiPriKey：酒店RSA算法密钥私钥
      8. cpiPubKey：酒店RSA算法密钥公钥
      9. cpiType：酒店支付类型
      10. createTime：酒店创建时间
      11. cpiAlipubKey：阿里支付宝公钥

API.CP03更新酒店信息接口 `1.2.1`

URL：/f2f/company/update
input：data=

{
    "cpiNo": "DL20160328000003",
    "cpiAppid": "2016032501241041",
    "cpiPid": "2088121307572082",
    "cpiPriKey": "true",
    "cpiPubKey": "true"
}&token=3cc3d0c0c8248746462d551e496c5520

示例:

{{ALPF2FHOST}}/f2f/company/update?data={"cpiNo":"DL20160328000003","cpiAppid":"2016032501241041","cpiPid":"2088121307572082"}&token=3cc3d0c0c8248746462d551e496c5520

参数说明
1. cpiNo：酒店编号
  - 调用方注册时酒店编号，作为更新依据，不能为空
2. cpiPid：支付宝伙伴id
  - 调用方需要修改的新支付宝伙伴id，可以为空
3. cpiAppid：appid
  - 调用方需要修改的新appid，可以为空
4. cpiPriKey：用户私钥
5. cpiPubKey：用户公钥
  - 公私钥是成对的，调用方若需要修改公私钥，需将cpiPriKey和cpiPubKey同时设置为true，可以为空
6. token：访问令牌 1.2.1
  - 必填，来自授权认证获取的访问令牌token
返回值
- 返回值类型：json
- 返回值结构：
  - 成功结果：

{
  "data": {
    "更新后的结果：": {
      "cpiAlipubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDI6d306Q8fIfCOaTXyiUeJHkrIvYISRcc73s3vF1ZT7XN8RNPwJxo8pWaJMmvyTn9N4HQ632qJBVHf8sxHi/fEsraprwCtzvzQETrNRwVxLO5jVmRGi60j8Ue1efIlzPXV9je9mkjzOmdssymZkh2QhUrCmZYI/FCEa3/cNMW0QIDAQAB",
      "cpiAppid": "2016032501241041",
      "cpiId": 2,
      "cpiNo": "DL20160328000003",
      "cpiPid": "2088121307572082",
      "cpiPriKey": "如果需要请联系工作人员！",
      "cpiPubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDpGHh3LX9Ni1N7uZPyy8PB7vMr5tg+ij678AN5/JMGRuMdS/U/ofxzopFhuNb7CO7UKI9p0Jq4S5jDbXVkZ8bPiEr0+0hRPmwqeSeViKrMy+ZBtkZNI4Y2Uu66DcFTRPUjMqsNdRWvebbdHhPHC6Nq4DNHTPdM8koBwoy3/X2srwIDAQAB",
      "cpiType": "f2f",
      "createTime": "2016-03-29 09:54:19"
    }
  },
  "err": "nothing",
  "msg": "success",
  "re": {},
  "reErr": {},
  "statusNo": 200,
  "version": "1.1.1"
}

- - 失败结果（以该公司门店不存在为例）

{
  "data": {},
  "err": "THE_CPINO_ERROR",
  "msg": "酒店编号错误！",
  "re": {},
  "reErr": {},
  "statusNo": 404,
  "version": "1.1.1"
}

- - 失败结果（以token无效为例）1.2.1

{
  "data": {},
  "err": "TOKEN_IS_INVALID",
  "msg": "访问令牌无效!请重新获取访问令牌!",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.2.1"
}

- 返回值说明：
  - 返回值说明：
  - 参数：
    - msg：请求结果信息
    - statusNo：请求状态码
    - data ：更新后的结果
      1. cpiAppid：APPID
      2. cpiId：酒店序号
      3. cpiNo：酒店编号
      4. cpiPid：合作伙伴PID
      5. cpiPriKey：酒店RSA算法密钥私钥
      6. cpiPubKey：酒店RSA算法密钥公钥
      7. cpiType：酒店支付类型
      8. createTime：酒店创建时间
      9. cpiAlipubKey：阿里支付宝公钥

API.FT01测试交易保障接口 `1.2.1`

URL：/f2f/test/{cpiNo}
input：cpiNo=

DL20160328000001?token=014287cdec233f366118a6eb4df51ce8

示例:

{{ALPF2FHOST}}/f2f/test/DL20160328000003?token=3a898544c65b8fc6f8fe62bbebd5d072

参数说明
1. cpiNo：酒店编号
  - 调用方注册时酒店编号
2. token：访问令牌 1.2.1
  - 必填，来自授权认证获取的访问令牌token
返回值
- 返回值类型：json
- 返回值结构：
  - 成功结果：

{
  "data": {
    "code": "10000",
    "msg": "同步心跳信息成功"
  },
  "err": "nothing",
  "msg": "success",
  "re": {},
  "reErr": {},
  "statusNo": 200,
  "version": "1.1.1"
}

- - 失败结果(以酒店编号不存在为例)

{
  "data": {},
  "err": "THE_CPI_ISNT_EXISTS",
  "msg": "找不到该公司信息,该企业码错误",
  "re": {},
  "reErr": {},
  "statusNo": 404,
  "version": "1.1.1"
}

- - 失败结果（以token无效为例）1.2.1

{
  "data": {},
  "err": "TOKEN_IS_INVALID",
  "msg": "访问令牌无效!请重新获取访问令牌!",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.2.1"
}

- 返回值说明：
  - 参数：
    1. msg：请求结果信息
    2. statusNo：请求状态码
    3. data
      - code：阿里接口返回状态码
      - msg: 同步心跳信息

API.FT02扫码支付（生成二维码）接口 `1.2.1`

URL：/f2f/qrcode
input：data=

{
    "cpiNo": "DL0001",
    "localNo": "00240",
    "totalAmount": "0.01",
    "operatorId": "op007",
    "storeId": "01",
    "subject": "迪联大酒店",
    "body": "支付标准间房费共115.00元"
}&token=014287cdec233f366118a6eb4df51ce8

示例:

{{ALPF2FHOST}}/f2f/qrcode?data={"cpiNo":"DL20160328000003","localNo":"319","totalAmount":"0.01","operatorId":"op007","storeId":"01","subject":"迪联测试主题","body":"测试一下"}&token=3a898544c65b8fc6f8fe62bbebd5d072

参数说明
1. cpiNo：调用方注册时酒店编号
  - 必填，非空
2. localNo：调用方的订单号
  - 必填，非空
3. totalAmount：订单总金额
  - 必填，非空
4. operatorId：操作员编号
  - 必填，非空
5. storeId：门店编号
  - 必填，非空
6. subject：订单标题
  - 必填，非空
7. body：订单描述
  - 必填，非空
8. token：访问令牌 1.2.1
  - 必填，来自授权认证获取的访问令牌token
返回值
- 返回值类型：json
- 返回值结构：
  - 成功结果：

{
  "data": {
    "code": "10000",
    "msg": "Success",
    "out_trade_no": "FF1603210000058",
    "qr_code": "https://qr.alipay.com/bax06116rybtbwhzcmss607f"
  },
  "err": "nothing",
  "msg": "success",
  "re": 1,
  "reErr": {},
  "statusNo": 200,
  "version": "1.1.0"
}

- - 失败结果（以酒店ID错误为例）

{
  "data": {},
  "err": "THE_CPI_ISNT_EXISTS",
  "msg": "找不到该公司信息,该企业码错误",
  "re": {},
  "reErr": {},
  "statusNo": 404,
  "version": "1.1.0"
}

- - 失败结果（以token无效为例）1.2.1

{
  "data": {},
  "err": "TOKEN_IS_INVALID",
  "msg": "访问令牌无效!请重新获取访问令牌!",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.2.1"
}

- 返回值说明：
  - 参数：
    1. msg：请求结果信息
    2. statusNo：请求状态码
    3. data
      - code：阿里接口返回状态码
      - msg：阿里接口返回处理信息
      - out_trade_no：订单编号
      - qr_code：二维码码值

API.FT03条码支付接口 `1.2.1`

URL：/f2f/hb_barcode
input：data=

{
    "cpiNo": "DL0001",
    "localNo": "00255",
    "totalAmount": "1.01",
    "operatorId": "op007",
    "storeId": "01",
    "authCode": "280104052451208862",
    "subject": "迪联测试主题",
    "body": "测试一下"
}&token=014287cdec233f366118a6eb4df51ce8

示例:

{{ALPF2FHOST}}/f2f/hb_barcode?data={"cpiNo":"DL20160328000003","localNo":"00259","totalAmount":"0.01","operatorId":"op007","storeId":"01","authCode":"280851932108273550","subject":"迪联测试主题","body":"测试一下"}&token=3a898544c65b8fc6f8fe62bbebd5d072

参数说明
1. cpiNo：调用方注册时酒店编号
  - 必填，非空
2. localNo：调用方的订单号
  - 必填，非空
3. totalAmount：订单总金额
  - 必填，非空
4. operatorId：操作员编号
  - 必填，非空
5. storeId：门店编号
  - 必填，非空
6. authCode：买家授权码
  - 必填，非空
7. subject：订单标题
  - 必填，非空
8. body：订单描述
  - 必填，非空
9. token：访问令牌 1.2.1
  - 必填，来自授权认证获取的访问令牌token
返回值
- 返回值类型：json
- 返回值结构：
  - 成功结果：

{
  "data": {},
  "err": "nothing",
  "msg": "success",
  "re": {
    "buyer_logon_id": "135****1239",
    "buyer_pay_amount": "0.01",
    "buyer_user_id": "2088802799515842",
    "code": "10000",
    "fund_bill_list": [
      {
        "amount": "0.01",
        "fund_channel": "ALIPAYACCOUNT"
      }
    ],
    "gmt_payment": "2016-03-21 14:39:30",
    "invoice_amount": "0.01",
    "msg": "Success",
    "open_id": "20881075855126105108930292015684",
    "out_trade_no": "FF1603210000059",
    "point_amount": "0.00",
    "receipt_amount": "0.01",
    "total_amount": "0.01",
    "trade_no": "2016032121001004840204701229"
  },
  "reErr": {},
  "statusNo": 200,
  "version": "1.1.1"
}

- - 失败结果（授权码过期为例）

{
  "data": {},
  "err": "nothing",
  "msg": "success",
  "re": {
    "buyer_logon_id": "135****1239",
    "buyer_pay_amount": "0.00",
    "buyer_user_id": "2088802799515842",
    "code": "40004",
    "invoice_amount": "0.00",
    "msg": "Business Failed",
    "open_id": "20881075855126105108930292015684",
    "out_trade_no": "FF1603210000052",
    "point_amount": "0.00",
    "receipt_amount": "0.00",
    "sub_code": "ACQ.TRADE_HAS_CLOSE",
    "sub_msg": "支付失败，本笔交易已关闭。[TRADE_HAS_CLOSE]"
  },
  "reErr": {},
  "statusNo": 200,
  "version": "1.1.1"
}

- - 失败结果（以token无效为例）1.2.1

{
  "data": {},
  "err": "TOKEN_IS_INVALID",
  "msg": "访问令牌无效!请重新获取访问令牌!",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.2.1"
}

- 返回值说明：
  - 参数：
    1. msg：请求结果信息
    2. statusNo：请求状态码
    3. re
      - code：阿里接口返回状态码
      - msg：阿里接口返回处理信息
      - out_trade_no：订单编号
      - 其他参数参见支付宝条码支付接口文档

API.FT04支付查询接口 `1.2.1`

URL：/f2f/query
input：data=

{
    "cpiNo": "DL20160328000002",
    "outTradeNo": "FF1603290000026"
}&token=014287cdec233f366118a6eb4df51ce8

示例:

{{ALPF2FHOST}}/f2f/query?data={"cpiNo":"DL20160328000003","outTradeNo":"FF1603290000028"}&token=3a898544c65b8fc6f8fe62bbebd5d072

参数说明
1. cpiNo：调用方注册时酒店编号
  - 必填，非空
2. outTradeNo：之前返回的订单号
  - 必填，非空
3. token：访问令牌 1.2.1
  - 必填，来自授权认证获取的访问令牌token
返回值
- 返回值类型：json
- 返回值结构：
  - 成功结果：

{
  "data": {
    "buyer_logon_id": "cod***@gmail.com",
    "buyer_pay_amount": "0.01",
    "buyer_user_id": "2088002126027695",
    "code": "10000",
    "fund_bill_list": [
      {
        "amount": "0.01",
        "fund_channel": "ALIPAYACCOUNT"
      }
    ],
    "invoice_amount": "0.01",
    "msg": "Success",
    "open_id": "20880047335234714124030730515669",
    "out_trade_no": "FF1603180000067",
    "point_amount": "0.00",
    "receipt_amount": "0.01",
    "send_pay_date": "2016-03-18 16:48:08",
    "total_amount": "0.01",
    "trade_no": "2016031821001004690268031394",
    "trade_status": "TRADE_SUCCESS"
  },
  "err": "nothing",
  "msg": "success",
  "re": {},
  "reErr": {},
  "statusNo": 200,
  "version": "1.0.1"
}

- - 失败结果（订单编号不存在为例）

{
  "data": {
    "buyer_pay_amount": "0.00",
    "code": "40004",
    "invoice_amount": "0.00",
    "msg": "Business Failed",
    "out_trade_no": "FF16031800000",
    "point_amount": "0.00",
    "receipt_amount": "0.00",
    "sub_code": "ACQ.TRADE_NOT_EXIST",
    "sub_msg": "交易不存在"
  },
  "err": "QUERY_FAILED",
  "msg": "查询失败！,请检查本地付款单号",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.1.0"
}

- - 失败结果（以token无效为例）1.2.1

{
  "data": {},
  "err": "TOKEN_IS_INVALID",
  "msg": "访问令牌无效!请重新获取访问令牌!",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.2.1"
}

- 返回值说明：
  - 参数：
    1. msg：请求结果信息
    2. statusNo：请求状态码
    3. data
      - code：阿里接口返回状态码
      - msg：阿里接口返回处理信息
      - out_trade_no：订单编号
      - 其他参数参见支付宝查询订单接口文档

API.FT05支付退款接口 `1.2.1`

URL：/f2f/refund
input：data=

{
    "cpiNo": "DL0001",
    "outTradeNo": "FF1603210000033",
    "refundAmount": "2.01",
    "outRequestNo": "01",
    "refundReason": "退款测试",
    "storeId": "01"
}&token=014287cdec233f366118a6eb4df51ce8

示例:

{{ALPF2FHOST}}/f2f/refund?data={"cpiNo":"DL20160328000003","outTradeNo":"FF1603290000028","refundAmount":"0.01","outRequestNo":"01","refundReason":"退款测试","storeId":"01"}&token=3a898544c65b8fc6f8fe62bbebd5d072

参数说明
1. cpiNo：调用方注册时酒店编号
  - 必填，非空
2. outTradeNo：支付时产生的订单号
  - 必填，非空
3. refundAmount：退款总金额不能超过订单支付金额
  - 必填，非空
4. outRequestNo：退款请求编号
  - 必填，非空
5. refundReason：退款说明
  - 必填，非空
6. storeId：门店编号
  - 必填，非空
7. token：访问令牌 1.2.1
  - 必填，来自授权认证获取的访问令牌token
返回值
- 返回值类型：json
- 返回值结构：
  - 成功结果：

{
  "data": {
    "buyer_logon_id": "135****1239",
    "buyer_user_id": "2088802799515842",
    "code": "10000",
    "fund_change": "Y",
    "gmt_refund_pay": "2016-03-21 14:58:37",
    "msg": "Success",
    "open_id": "20881075855126105108930292015684",
    "out_trade_no": "FF1603210000034",
    "refund_detail_item_list": [
      {
        "amount": "1.01",
        "fund_channel": "ALIPAYACCOUNT"
      }
    ],
    "refund_fee": "1.01",
    "send_back_fee": "1.01",
    "trade_no": "2016032121001004840206340827"
  },
  "err": "nothing",
  "msg": "success",
  "re": {},
  "reErr": {},
  "statusNo": 200,
  "version": "1.1.0"
}

- - 失败结果（订单编号不存在为例）

{
  "data": {
    "code": "40004",
    "msg": "Business Failed",
    "refund_fee": "0.00",
    "send_back_fee": "0.00",
    "sub_code": "ACQ.TRADE_NOT_EXIST",
    "sub_msg": "交易不存在"
  },
  "err": "REFUND_FAILED",
  "msg": "退款失败！,请检查本地付款单号",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.1.0"
}

- - 失败结果（以token无效为例）1.2.1

{
  "data": {},
  "err": "TOKEN_IS_INVALID",
  "msg": "访问令牌无效!请重新获取访问令牌!",
  "re": {},
  "reErr": {},
  "statusNo": 400,
  "version": "1.2.1"
}

- 返回值说明：
  - 参数：
    1. msg：请求结果信息
    2. statusNo：请求状态码
    3. data
      - code：阿里接口返回状态码
      - msg：阿里接口返回处理信息
      - out_trade_no：订单编号
      - 其他参数参见支付宝申请退款接口接口文档

alipay-f2f 接口api文档

版本号:`1.1.1`=>`1.2.1`

部门:`研发部`

岗位:`服务端开发人员`

姓名:`杨松`

建立日期:`2016-3-22`

更新日期:`2016-5-17 16：42`

POSTMAN 测试接口：`https://www.getpostman.com/collections/5515a900ec118fa56d52`

alipay-f2f流程图：

DOMAIN 主机域名定义 env

API.AH01生成secretKey接口 `1.2.1`

API.AH02获取访问令牌token接口 `1.2.1`

API.CP01录入酒店信息接口 `1.2.1`

API.CP02查询酒店信息接口 `1.2.1`

API.CP03更新酒店信息接口 `1.2.1`

API.FT01测试交易保障接口 `1.2.1`

API.FT02扫码支付（生成二维码）接口 `1.2.1`

API.FT03条码支付接口 `1.2.1`

API.FT04支付查询接口 `1.2.1`

API.FT05支付退款接口 `1.2.1`

alipay-f2f 接口api文档

版本号:1.1.1=>1.2.1

部门:研发部

岗位:服务端开发人员

姓名:杨松

建立日期:2016-3-22

更新日期:2016-5-17 16：42

POSTMAN 测试接口：https://www.getpostman.com/collections/5515a900ec118fa56d52

alipay-f2f流程图 ：

DOMAIN 主机域名定义 env

API.AH01生成secretKey接口 1.2.1

API.AH02获取访问令牌token接口 1.2.1

API.CP01录入酒店信息接口 1.2.1

API.CP02查询酒店信息接口 1.2.1

API.CP03更新酒店信息接口 1.2.1

API.FT01测试交易保障接口 1.2.1

API.FT02扫码支付（生成二维码）接口 1.2.1

API.FT03条码支付接口 1.2.1

API.FT04支付查询接口 1.2.1

API.FT05支付退款接口 1.2.1

内容目录

版本号:`1.1.1`=>`1.2.1`

部门:`研发部`

岗位:`服务端开发人员`

姓名:`杨松`

建立日期:`2016-3-22`

更新日期:`2016-5-17 16：42`

POSTMAN 测试接口：`https://www.getpostman.com/collections/5515a900ec118fa56d52`

alipay-f2f流程图：

API.AH01生成secretKey接口 `1.2.1`

API.AH02获取访问令牌token接口 `1.2.1`

API.CP01录入酒店信息接口 `1.2.1`

API.CP02查询酒店信息接口 `1.2.1`

API.CP03更新酒店信息接口 `1.2.1`

API.FT01测试交易保障接口 `1.2.1`

API.FT02扫码支付（生成二维码）接口 `1.2.1`

API.FT03条码支付接口 `1.2.1`

API.FT04支付查询接口 `1.2.1`

API.FT05支付退款接口 `1.2.1`