接口集成

签约中描述了销售方案中包含的接口列表，但是并不是所有接口都必须开发的。具体开发哪些接口需要根据商户的业务场景来决定。下面介绍几种常见场景下的接口调用：

1.1即时到账交易付款

机票行业即时到账签约支持18个月退款周期，具体退款周期由签约销售方案中BD指定。

涉及接口：即时到账交易接口(create_direct_pay_by_user)

1.2无密代扣付款

代扣方便采购商、平台、以及供应商之间的资金快速流动，解决小采购不能实时在线支付的问题，委托平台从其账户代扣票款并出票。

涉及接口：

1）支付圈签约接口(sign_protocol_with_partner)，代扣前必须签约支付圈自动扣款协议，否则无法完成扣款。

2）机票CAE代扣接口(cae_charge_agent)，无需付款方参与，平台调用接口直接从与平台签约了代扣协议的账户中完成扣款出票。

1.3无密退款接口（实时多级一体化退款）

涉及接口：

1）支付圈签约接口(sign_protocol_with_partner)（无密退款前，分润方必须和商户签约该协议，否则会导致无法退分润款。该接口由商家调用，引导用户去页面完成“自动退款协议”签约）。

2）即时到账批量退款无密接口(refund_fastpay_by_platform_nopwd)无需人工确认，一次性接口调用直接完成退款（如需退分润，必须传入退分润参数）。

3）机票交易委托冻结、解冻和代扣接口（可以保证退款顺利进行，商户根据需要选择，此接口非必选）。

机票交易退款冻结解冻接口(air_trade_refund_freeze、air_trade_refund_freeze_query、air_trade_refund_unfreeze、air_trade_refund_unfreeze_query)

往往应用在退款前先操作冻结，再操作解冻，用于提高退款成功率。

2．接口功能及参数介绍

2.1多级分润接口

应用场景：买家付完款后,交易未超时且交易未关闭（即：交易状态为trade_success）时可以调用多级分润接口进行分润。

业务流程：

注意：该流程一般是先将资金支付到平台中间账户，由平台决定何时将资金分润给供应商账户（分润的时间不要超过订单有效退款时间）

接口注意事项：

• royalty_parameters分润参数,分润参数顺序问题:分润顺序按参数传入顺序执行,所有分润必须满足”入大于出,先入后出”原则；
• 分润最多支持10级，即|最多出现9次；
• 分润信息中“备注”可以为空，但是“^”不可以省略。备注字段长度不能超过80个字节，即40个汉字；
• 分润的通知是按照标准即时到账的通知地址（notify_url）进行通知。
• 分润格式：分润格式支持平级和多级两种格式。

（1）平级分润

收款方支付宝账号(UID)1^金额1^备注1|收款方支付宝账号(UID)2^金额2^备注2….收款方支付宝账号（UID）N^金额N^备注N

（2）多级分润

付款方支付宝账号（UID）^收款方支付宝账号（UID）1^金额1^备注1|付款方支付宝账号（UID）1^收款方支付宝账号（UID）2^金额2^备注2...|付款方支付宝账号（UID）N^收款方支付宝账号（UID）N^金额N^备注N

示例：

A为交易卖家，A需要分润给B“10元”，B再分润给C“5元”。

则分润明细参数应该为： A^B^10^分润10元|B^C^5^分润5元

或

B^10^分润10元|B^C^5^分润5元

2.2即时到账退款（无密）接口

在买家付完款后，交易未超时,且交易未关闭时（交易状态为trade_success）可以调用该接口，该接口支持多次调用,直至全部款项都退完,交易关闭，交易状态变更为trade_closed。

接口注意事项

1. 同一批次中不允许包含两条交易号相同的退款明细，同一条退款明细中不允许存在两条卖家和买家相同的退分润信息。
2. 退款数据集（detail_data）：

批次中的退款明细中多笔订单用’#’分隔，退分润用‘|’分隔,具体如下：

“第一笔交易#第二笔交易#第三笔交易“多笔交易之间用#分割。

“第X笔交易“格式为：交易退款数据集|分润退款数据集|分润退款数据集2|…|分润退款数据集N。

注意：支付宝支持接口批量退款，批量数据最多1千条。数据请求以表单POST方式发送到支付宝，否则无法传递大量数据。

数据格式要求如下：

交易退款数据集格式为：原付款支付宝交易号^退款总金额^退款理由。

分润退款数据集格式为：转出人支付宝账号[原收到分润金额的账户]^转出人支付宝账号对应用户ID[2088开头16位纯数字]^转入人支付宝账号[原付出分润金额的账户]^转入人支付宝账号对应用户ID^退款金额^退款理由。

退款模式	退款格式	优缺点
平台响应退款数据集格式	原付款支付宝交易号^退交易金额^退款理由|转出人Email（原分润帐户）^转出人userId^转入人Email（平台中间帐户）^转入人userId^退款金额^退款理由	优点：和支付宝交互少 缺点：分润方资金不足，平台资金充足，平台会垫付退款资金（有些平台会申请设置退款和退分润在同一事务中来规避垫退问题，需要找支付宝客户经理申请配置）
供应商响应退款数据集格式	分润方退款格式： 原付款支付宝交易号^0^退款理由|转出人Email（原分润帐户）^转出人userId^转入人Email（平台中间帐户）^转入人userId^退款金额^退款理由	优点：可以保证分润方必须将资金退给平台 缺点：交互次数多，需要调用两次退款接口，第一次退分润，第二次退款给买家。
	平台退款格式： 原付款支付宝交易号^退款金额^退款理由
备注：以上2中格式有商户自由选择，如果有疑问可以咨询支付宝技术人员。

 

3. 退款返回结果数据集（result_details）：

退款模式	退款格式	备注
平台响应退款结果集格式	原付款支付宝交易号^退交易金额^处理结果码$被收费人Email（也就是在交易的时候支付宝收取服务费的账户）^被收费人userId^退款金额^处理结果码|转出人Email（原分润帐户）^转出人userId^转入人Email（平台中间帐户）^转入人userId^退款金额^处理结果码|转出人Email^转出人userId^转入人Email^转入人userId^退款金额^处理结果码	需要注意提醒商户是否返回退手续费参数部分需要做好兼容，有退费金额的情况下才会返回该参数。
供应商响应退款结果集格式	分润方退款格式： 原付款支付宝交易号^0^退款理由^处理结果码|转出人Email（原分润帐户）^转出人userId^转入人Email（平台中间帐户）^转入人userId^退款金额^处理结果码	样例：2008011801009807^0.00^SUCCESS |lands800-31@yahoo.com.cn^^lands800-30@yahoo.com.cn^^3.01^SUCCESS|lands800-40@yahoo.com.cn^^lands800-30@yahoo.com.cn^^4.01^SUCCESS
	平台退款格式： 原付款支付宝交易号^退款金额^处理结果码$被收费人Email（也就是在交易的时候支付宝收取服务费的账户）^被收费人userId^退款金额^处理结果码	样例：2008011801009807^90.00^SUCCESS$lands800-30@yahoo.com.cn^^4.01^SUCCESS

4. 调用此接口同步的response返回成功只代表批量退款申请被接受。系统异步执行批量退款的结果应以异步通知过为准，参见notify_url的返回。

2.3支付圈签约接口

使用机票cae代扣功能前，必须签约支付圈自动代扣协议，否则无法完成扣款。

自动退款是可选项，如果有退款需求，则需要签约支付圈自动退款协议。

业务流程：

2.4机票CAE代扣接口

通过机票cae代扣接口，无需付款方参与，平台调用接口直接从与平台签约了代扣协议的账户中完成扣款出票。

接口注意事项：

1. 转出支付宝账号(trans_account_out)， 该账户必须先调用支付圈签约借口，签约自动支付协议，方可使用。
2. 支付结果需以异步通知为准。同步返回只代表支付请求提交成功，不代表处理成功。异步通知没收到以查询接口为准。
3. 在订单状态status为wait_buyer_pay状态下，商户不能更改out_trade_no（商户订单号）再次发起扣款，防止同一张机票被扣款两次。
4. 机票CAE代扣仅支持支付宝余额支付，不支持其他支付形式。当返回错误码USER_PAY_TYPE_MISMATCH时，代表用户账户余额和余额宝都没有钱，或者用户余额支付功能关闭。但用户往自己的账户充钱后，在交易已经创建的前提下，接口不支持二次支付，商户需要通过更换商户订单号out_trade_no才可能扣款成功。

 

3．对账

接口对账方式和其他接口对账方式一致，无个性化。

1、Sftp账单模式：该模式需要联系对应的业务经理（BD）申请sftp账户和账单模板配置。
接口 (alipay.data.dataservice.bill.downloadurl.query)获取账单，自动导入系统做系统对账，一般情况下用账务明细分页查询接口较多，离线账单获取是2.0接口一般机票类商户都没有签约2.0产品所以无权限，如需使用需要单独签约后才能使用。
3、支付宝站内下载账单：签约账户登录www.alipay.com，到对账中心--账单下载中下载日账单。

FAQ

关于此文档暂时还没有FAQ