签约销售方案共包含8个接口,各接口描述和使用场景详见下表接口使用说明(接口文档尚未在线上开放,需要请联系雨菲获取)。
接口英文名 |
接口名称 |
描述 |
使用场景 |
alipay.fund.auth.order.freeze |
资金授权冻结接口 |
通过调用该接口创建支付宝授权订单并完成资金冻结 |
收银员使用扫码设备读取用户支付宝钱包“付款码”后,将二维码或条码信息和订单信息通过本接口上送至支付宝发起资金授权冻结。
|
alipay.fund.auth.order.voucher.create |
资金授权发码接口 |
通过调用该接口创建支付宝授权订单并完成资金冻结 |
收银员通过收银台或商户后台调用支付宝接口,生成二维码后,展示给用户,由用户扫描二维码完成资金冻结。 |
alipay.fund.auth.operation.cancel |
资金授权撤销接口 |
通过调用该接口撤销授权冻结操作 |
只有发生授权系统超时或者授权结果未知时可调用撤销,其他正常授权冻结的操作如需实现相同功能请调用资金授权解冻服务。提交资金授权后调用【资金授权操作查询】,没有明确的授权结果再调用【资金授权撤销】 |
alipay.fund.auth.order.unfreeze |
资金授权解冻接口 |
支持部分和全部解冻 |
当资金授权发生之后一段时间内,由于买家或者商家等其他原因需要要解冻资金,商家可通过资金授权解冻接口将授权资金进行解冻,支付宝将在收到解冻请求并验证成功后,按解冻规则将冻结资金进行解冻,原路退回支付宝账号 |
alipay.fund.auth.operation.detail.query |
资金授权操作查询接口 |
通过调用该接口查询授权操作明细信息 |
商家后台、网络、服务器等出现异常,商户系统最终未接收到支付通知;调用资金授权冻结接口后,返回系统错误或未知交易状态情况;调用资金授权冻结请求后,返回处理中的状态(返回结果中的code等于10003);注意:调用撤销接口之前,需通过操作查询接口确认该笔授权操作目前的状态(返回结果status=”SUCCESS”表明授权操作成功)。 当商家调用“资金授权解冻接口”时出现系统错误,商户可使用该接口查询提交的解冻请求是否执行成功。 |
alipay.trade.pay |
交易创建并支付接口 |
通过调用该接口创建支付宝交易订单 并使用预授权资金完成支付 |
当商家需要对用户授权资金进行解冻支付时,商家可通过交易创建并支付接口将用户授权资金支付给卖家,支付宝将在收到请求后创建相应交易单并将授权资金支付给卖家 |
alipay.trade.refund |
交易同步退款接口
|
支持部分和全部退款
|
当交易发生之后一段时间内,由于买家或者卖家的原因需退款,卖家可通过退款接口将支付款退还给买家,支付宝将在收到退款请求并验证成功后,按退款规则将支付款按原路退到买家帐号上
|
alipay.trade.query |
交易订单查询接口 |
通过调用该接口查询订单的状态 |
商户后台、网络、服务器等出现异常,商户系统最终未接收到支付通知; |