[关闭]
@931876502 2016-05-26T16:09:59.000000Z 字数 14588 阅读 776

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

{{ALIPAYF2F}}

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

  1. B996377230C16FEF1BA98F127C1A4570
  1. {{ALIPAYF2F}}/auth/secret?dogNo=B996377230C16FEF1BA98F127C1A4570
  1. {
  2.   "data": {
  3.     "dogNo": "B996377230C16FEF1BA98F127C1A4570",
  4.     "secretKey": "2a99b6c4956d7990367aebc666e120a3",
  5.     "skId": 1
  6.   },
  7.   "err": "nothing",
  8.   "msg": "success",
  9.   "re": {},
  10.   "reErr": {},
  11.   "statusNo": 200,
  12.   "version": "1.2.1"
  13. }
  1. {
  2.   "data": {},
  3.   "err": "DOGNO_LENGTH_IS_ERROR",
  4.   "msg": "加密狗号长度为32位!!",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.2.1"
  9. }

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

  1. input：dogNo=B996377230C16FEF1BA98F127C1A4570&secretKey=82de52b5a1fe740e865f52b5d5d1ff86
  1. {{ALIPAYF2F}}/auth/token?dogNo=B996377230C16FEF1BA98F127C1A4570&secretKey=d339a12def4a3c1073ed2aeda92b1c64
  1. {
  2.   "data": {
  3.     "ahId": 1,
  4.     "dogNo": "B996377230C16FEF1BA98F127C1A4570",
  5.     "endTime": "2016-05-11 12:30:51",
  6.     "token": "985cf8a87e129d25d7b7c49d2422eb72"
  7.   },
  8.   "err": "nothing",
  9.   "msg": "success",
  10.   "re": {},
  11.   "reErr": {},
  12.   "statusNo": 200,
  13.   "version": "1.2.1"
  14. }
  1. {
  2.   "data": {},
  3.   "err": "DOGNO_IS_NOT_MATCH_SECRETKEY",
  4.   "msg": "加密狗号与密钥不匹配!",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.2.1"
  9. }

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

  1. {"storeDogNo":"DL00066","cpiPid":"2088212612254566","cpiAppid":"2016022901171807"}&token=014287cdec233f366118a6eb4df51ce8
  1. {{ALIPAYF2F}}/f2f/company/add?data={"storeDogNo":"DL001118","cpiPid":"2088212612254111","cpiAppid":"2016022901171807"}&token=3a898544c65b8fc6f8fe62bbebd5d072
  1. {
  2.   "data": {
  3.     "cpiId": 1,
  4.     "cpiType": "f2f",
  5.     "storeNo": "006",
  6.     "cpiAppid": "2016022901171807",
  7.     "cpiPid": "2088212612254566",
  8.     "cpiPubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDs/2Ia7xNHx+6laa/nB1xQWxi7OsTHQqOMa7KRavVdu2z6yjRUKkx91sQhhr3fcooE1TlxDH+fgr9LbtBh2yxWs4g0+yU7nF4xzOpkZjLUVf2W/XaNJ+e3Sf0GoARyKEjgocKaNyiFuEdjUBy/MoGVI69WVlkt/X3QeeYzf9+pFQIDAQAB",
  9.     "createTime": 1459150408985,
  10.     "cpiPriKey": "如果需要请联系工作人员！",
  11.     "storeDogNo": "DL00066",
  12.     "cpiNo": "DL20160328000001",
  13.     "cpiAlipubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDI6d306Q8fIfCOaTXyiUeJHkrIvYISRcc73s3vF1ZT7XN8RNPwJxo8pWaJMmvyTn9N4HQ632qJBVHf8sxHi"
  14.   },
  15.   "err": "nothing",
  16.   "msg": "success",
  17.   "re": {},
  18.   "reErr": {},
  19.   "statusNo": 200,
  20.   "version": "1.0.1"
  21. }
  1. {
  2.   "data": {},
  3.   "err": "DOGNO_ALREADY_EXISTS",
  4.   "msg": "该加密狗号已经被使用！",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.0.1"
  9. }
  1. {
  2.   "data": {},
  3.   "err": "TOKEN_IS_INVALID",
  4.   "msg": "访问令牌无效!请重新获取访问令牌!",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.2.1"
  9. }

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

  1. {"cpiNo":"DL20160328000001","storeNo":"001"}&token=014287cdec233f366118a6eb4df51ce8
  2. 或者：
  3. {"storeDogNo":"DL0001"}&token=014287cdec233f366118a6eb4df51ce8
  1. {{ALPF2FHOST}}/f2f/company/query?data={"cpiNo":"DL20160328000003","storeNo":"001"}&token=3a898544c65b8fc6f8fe62bbebd5d072
  1. {
  2.   "data": {
  3.     "cpiId": 1,
  4.     "cpiType": "f2f",
  5.     "storeNo": "001",
  6.     "cpiAppid": "2016032501241041",
  7.     "cpiPid": "2088121307572082",
  8.     "cpiPubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDFJBf36pmn+Q0MD4JWoIVLzGw7cdurOn3Hp0x1CnpMKyJHZLRRtz419LvTmOelrIuevklHLLZfkzkt14alDwuHxqqO+fS24mBYqdVcFtAQhN2H5fy0mbl32mIQ3OpyWZGGzPOpR6aHknDbVj2hNqW5S84KddQnWVN/9ZB101CWnQIDAQAB",
  9.     "createTime": "2016-03-28 20:20:00",
  10.     "cpiPriKey": "如果需要请联系工作人员！",
  11.     "storeDogNo": "DL0001",
  12.     "cpiNo": "DL20160328000002",
  13.     "cpiAlipubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDI6d306Q8fIfCOaTXyiUeJHkrIvYISRcc73s3vF1ZT7XN8RNPwJxo8pWaJMmvyTn9N4HQ632qJBVHf8sxHi/fEsraprwCtzvzQETrNRwVxLO5jVmRGi60j8Ue1efIlzPXV9je9mkjzOmdssymZkh2QhUrCmZYI/FCEa3/cNMW0QIDAQAB"
  14.   },
  15.   "err": "nothing",
  16.   "msg": "success",
  17.   "re": {},
  18.   "reErr": {},
  19.   "statusNo": 200,
  20.   "version": "1.1.1"
  21. }
  1. {
  2.   "data": {},
  3.   "err": "RESULT_NOT_EXISTS",
  4.   "msg": "查询结果不存在，请检查参数！",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.1.1"
  9. }
  1. {
  2.   "data": {},
  3.   "err": "TOKEN_IS_INVALID",
  4.   "msg": "访问令牌无效!请重新获取访问令牌!",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.2.1"
  9. }

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

  1. {
  2.     "cpiNo": "DL20160328000003",
  3.     "cpiAppid": "2016032501241041",
  4.     "cpiPid": "2088121307572082",
  5.     "cpiPriKey": "true",
  6.     "cpiPubKey": "true"
  7. }&token=3cc3d0c0c8248746462d551e496c5520
  1. {{ALPF2FHOST}}/f2f/company/update?data={"cpiNo":"DL20160328000003","cpiAppid":"2016032501241041","cpiPid":"2088121307572082"}&token=3cc3d0c0c8248746462d551e496c5520
  1. {
  2.   "data": {
  3.     "更新后的结果：": {
  4.       "cpiAlipubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDI6d306Q8fIfCOaTXyiUeJHkrIvYISRcc73s3vF1ZT7XN8RNPwJxo8pWaJMmvyTn9N4HQ632qJBVHf8sxHi/fEsraprwCtzvzQETrNRwVxLO5jVmRGi60j8Ue1efIlzPXV9je9mkjzOmdssymZkh2QhUrCmZYI/FCEa3/cNMW0QIDAQAB",
  5.       "cpiAppid": "2016032501241041",
  6.       "cpiId": 2,
  7.       "cpiNo": "DL20160328000003",
  8.       "cpiPid": "2088121307572082",
  9.       "cpiPriKey": "如果需要请联系工作人员！",
  10.       "cpiPubKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDpGHh3LX9Ni1N7uZPyy8PB7vMr5tg+ij678AN5/JMGRuMdS/U/ofxzopFhuNb7CO7UKI9p0Jq4S5jDbXVkZ8bPiEr0+0hRPmwqeSeViKrMy+ZBtkZNI4Y2Uu66DcFTRPUjMqsNdRWvebbdHhPHC6Nq4DNHTPdM8koBwoy3/X2srwIDAQAB",
  11.       "cpiType": "f2f",
  12.       "createTime": "2016-03-29 09:54:19"
  13.     }
  14.   },
  15.   "err": "nothing",
  16.   "msg": "success",
  17.   "re": {},
  18.   "reErr": {},
  19.   "statusNo": 200,
  20.   "version": "1.1.1"
  21. }
  1. {
  2.   "data": {},
  3.   "err": "THE_CPINO_ERROR",
  4.   "msg": "酒店编号错误！",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 404,
  8.   "version": "1.1.1"
  9. }
  1. {
  2.   "data": {},
  3.   "err": "TOKEN_IS_INVALID",
  4.   "msg": "访问令牌无效!请重新获取访问令牌!",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.2.1"
  9. }

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

  1. DL20160328000001?token=014287cdec233f366118a6eb4df51ce8
  1. {{ALPF2FHOST}}/f2f/test/DL20160328000003?token=3a898544c65b8fc6f8fe62bbebd5d072
  1. {
  2.   "data": {
  3.     "code": "10000",
  4.     "msg": "同步心跳信息成功"
  5.   },
  6.   "err": "nothing",
  7.   "msg": "success",
  8.   "re": {},
  9.   "reErr": {},
  10.   "statusNo": 200,
  11.   "version": "1.1.1"
  12. }
  1. {
  2.   "data": {},
  3.   "err": "THE_CPI_ISNT_EXISTS",
  4.   "msg": "找不到该公司信息,该企业码错误",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 404,
  8.   "version": "1.1.1"
  9. }
  1. {
  2.   "data": {},
  3.   "err": "TOKEN_IS_INVALID",
  4.   "msg": "访问令牌无效!请重新获取访问令牌!",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.2.1"
  9. }

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

  1. {
  2.     "cpiNo": "DL0001",
  3.     "localNo": "00240",
  4.     "totalAmount": "0.01",
  5.     "operatorId": "op007",
  6.     "storeId": "01",
  7.     "subject": "迪联大酒店",
  8.     "body": "支付标准间房费共115.00元"
  9. }&token=014287cdec233f366118a6eb4df51ce8
  1. {{ALPF2FHOST}}/f2f/qrcode?data={"cpiNo":"DL20160328000003","localNo":"319","totalAmount":"0.01","operatorId":"op007","storeId":"01","subject":"迪联测试主题","body":"测试一下"}&token=3a898544c65b8fc6f8fe62bbebd5d072
  1. {
  2.   "data": {
  3.     "code": "10000",
  4.     "msg": "Success",
  5.     "out_trade_no": "FF1603210000058",
  6.     "qr_code": "https://qr.alipay.com/bax06116rybtbwhzcmss607f"
  7.   },
  8.   "err": "nothing",
  9.   "msg": "success",
  10.   "re": 1,
  11.   "reErr": {},
  12.   "statusNo": 200,
  13.   "version": "1.1.0"
  14. }
  1. {
  2.   "data": {},
  3.   "err": "THE_CPI_ISNT_EXISTS",
  4.   "msg": "找不到该公司信息,该企业码错误",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 404,
  8.   "version": "1.1.0"
  9. }
  1. {
  2.   "data": {},
  3.   "err": "TOKEN_IS_INVALID",
  4.   "msg": "访问令牌无效!请重新获取访问令牌!",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.2.1"
  9. }

API.FT03条码支付接口 1.2.1

  1. {
  2.     "cpiNo": "DL0001",
  3.     "localNo": "00255",
  4.     "totalAmount": "1.01",
  5.     "operatorId": "op007",
  6.     "storeId": "01",
  7.     "authCode": "280104052451208862",
  8.     "subject": "迪联测试主题",
  9.     "body": "测试一下"
  10. }&token=014287cdec233f366118a6eb4df51ce8
  1. {{ALPF2FHOST}}/f2f/hb_barcode?data={"cpiNo":"DL20160328000003","localNo":"00259","totalAmount":"0.01","operatorId":"op007","storeId":"01","authCode":"280851932108273550","subject":"迪联测试主题","body":"测试一下"}&token=3a898544c65b8fc6f8fe62bbebd5d072
  1. {
  2.   "data": {},
  3.   "err": "nothing",
  4.   "msg": "success",
  5.   "re": {
  6.     "buyer_logon_id": "135****1239",
  7.     "buyer_pay_amount": "0.01",
  8.     "buyer_user_id": "2088802799515842",
  9.     "code": "10000",
  10.     "fund_bill_list": [
  11.       {
  12.         "amount": "0.01",
  13.         "fund_channel": "ALIPAYACCOUNT"
  14.       }
  15.     ],
  16.     "gmt_payment": "2016-03-21 14:39:30",
  17.     "invoice_amount": "0.01",
  18.     "msg": "Success",
  19.     "open_id": "20881075855126105108930292015684",
  20.     "out_trade_no": "FF1603210000059",
  21.     "point_amount": "0.00",
  22.     "receipt_amount": "0.01",
  23.     "total_amount": "0.01",
  24.     "trade_no": "2016032121001004840204701229"
  25.   },
  26.   "reErr": {},
  27.   "statusNo": 200,
  28.   "version": "1.1.1"
  29. }
  1. {
  2.   "data": {},
  3.   "err": "nothing",
  4.   "msg": "success",
  5.   "re": {
  6.     "buyer_logon_id": "135****1239",
  7.     "buyer_pay_amount": "0.00",
  8.     "buyer_user_id": "2088802799515842",
  9.     "code": "40004",
  10.     "invoice_amount": "0.00",
  11.     "msg": "Business Failed",
  12.     "open_id": "20881075855126105108930292015684",
  13.     "out_trade_no": "FF1603210000052",
  14.     "point_amount": "0.00",
  15.     "receipt_amount": "0.00",
  16.     "sub_code": "ACQ.TRADE_HAS_CLOSE",
  17.     "sub_msg": "支付失败，本笔交易已关闭。[TRADE_HAS_CLOSE]"
  18.   },
  19.   "reErr": {},
  20.   "statusNo": 200,
  21.   "version": "1.1.1"
  22. }
  1. {
  2.   "data": {},
  3.   "err": "TOKEN_IS_INVALID",
  4.   "msg": "访问令牌无效!请重新获取访问令牌!",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.2.1"
  9. }

API.FT04支付查询接口 1.2.1

  1. {
  2.     "cpiNo": "DL20160328000002",
  3.     "outTradeNo": "FF1603290000026"
  4. }&token=014287cdec233f366118a6eb4df51ce8
  1. {{ALPF2FHOST}}/f2f/query?data={"cpiNo":"DL20160328000003","outTradeNo":"FF1603290000028"}&token=3a898544c65b8fc6f8fe62bbebd5d072
  1. {
  2.   "data": {
  3.     "buyer_logon_id": "cod***@gmail.com",
  4.     "buyer_pay_amount": "0.01",
  5.     "buyer_user_id": "2088002126027695",
  6.     "code": "10000",
  7.     "fund_bill_list": [
  8.       {
  9.         "amount": "0.01",
  10.         "fund_channel": "ALIPAYACCOUNT"
  11.       }
  12.     ],
  13.     "invoice_amount": "0.01",
  14.     "msg": "Success",
  15.     "open_id": "20880047335234714124030730515669",
  16.     "out_trade_no": "FF1603180000067",
  17.     "point_amount": "0.00",
  18.     "receipt_amount": "0.01",
  19.     "send_pay_date": "2016-03-18 16:48:08",
  20.     "total_amount": "0.01",
  21.     "trade_no": "2016031821001004690268031394",
  22.     "trade_status": "TRADE_SUCCESS"
  23.   },
  24.   "err": "nothing",
  25.   "msg": "success",
  26.   "re": {},
  27.   "reErr": {},
  28.   "statusNo": 200,
  29.   "version": "1.0.1"
  30. }
  1. {
  2.   "data": {
  3.     "buyer_pay_amount": "0.00",
  4.     "code": "40004",
  5.     "invoice_amount": "0.00",
  6.     "msg": "Business Failed",
  7.     "out_trade_no": "FF16031800000",
  8.     "point_amount": "0.00",
  9.     "receipt_amount": "0.00",
  10.     "sub_code": "ACQ.TRADE_NOT_EXIST",
  11.     "sub_msg": "交易不存在"
  12.   },
  13.   "err": "QUERY_FAILED",
  14.   "msg": "查询失败！,请检查本地付款单号",
  15.   "re": {},
  16.   "reErr": {},
  17.   "statusNo": 400,
  18.   "version": "1.1.0"
  19. }
  1. {
  2.   "data": {},
  3.   "err": "TOKEN_IS_INVALID",
  4.   "msg": "访问令牌无效!请重新获取访问令牌!",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.2.1"
  9. }

API.FT05支付退款接口 1.2.1

  1. {
  2.     "cpiNo": "DL0001",
  3.     "outTradeNo": "FF1603210000033",
  4.     "refundAmount": "2.01",
  5.     "outRequestNo": "01",
  6.     "refundReason": "退款测试",
  7.     "storeId": "01"
  8. }&token=014287cdec233f366118a6eb4df51ce8
  1. {{ALPF2FHOST}}/f2f/refund?data={"cpiNo":"DL20160328000003","outTradeNo":"FF1603290000028","refundAmount":"0.01","outRequestNo":"01","refundReason":"退款测试","storeId":"01"}&token=3a898544c65b8fc6f8fe62bbebd5d072
  1. {
  2.   "data": {
  3.     "buyer_logon_id": "135****1239",
  4.     "buyer_user_id": "2088802799515842",
  5.     "code": "10000",
  6.     "fund_change": "Y",
  7.     "gmt_refund_pay": "2016-03-21 14:58:37",
  8.     "msg": "Success",
  9.     "open_id": "20881075855126105108930292015684",
  10.     "out_trade_no": "FF1603210000034",
  11.     "refund_detail_item_list": [
  12.       {
  13.         "amount": "1.01",
  14.         "fund_channel": "ALIPAYACCOUNT"
  15.       }
  16.     ],
  17.     "refund_fee": "1.01",
  18.     "send_back_fee": "1.01",
  19.     "trade_no": "2016032121001004840206340827"
  20.   },
  21.   "err": "nothing",
  22.   "msg": "success",
  23.   "re": {},
  24.   "reErr": {},
  25.   "statusNo": 200,
  26.   "version": "1.1.0"
  27. }
  1. {
  2.   "data": {
  3.     "code": "40004",
  4.     "msg": "Business Failed",
  5.     "refund_fee": "0.00",
  6.     "send_back_fee": "0.00",
  7.     "sub_code": "ACQ.TRADE_NOT_EXIST",
  8.     "sub_msg": "交易不存在"
  9.   },
  10.   "err": "REFUND_FAILED",
  11.   "msg": "退款失败！,请检查本地付款单号",
  12.   "re": {},
  13.   "reErr": {},
  14.   "statusNo": 400,
  15.   "version": "1.1.0"
  16. }
  1. {
  2.   "data": {},
  3.   "err": "TOKEN_IS_INVALID",
  4.   "msg": "访问令牌无效!请重新获取访问令牌!",
  5.   "re": {},
  6.   "reErr": {},
  7.   "statusNo": 400,
  8.   "version": "1.2.1"
  9. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注