代收冻结接口使用说明

时间: 2018-08-17 | 点击: | 栏目: 接口说明

p2p标的募集一般存在一种场景:

    标的发起,标的募集期为5天为例,新浪将为此提供接口方案为:

 

    客户A跳转收银台调用【代收冻结】100元,使用【余额支付】->

    操作完成后,客户的可用余额减少100,冻结余额增加100(若是存钱罐账户将继续享受收益)->

    新浪异步推送订单交易状态为:PRE_AUTH_APPLY_SUCCESS,p2p程序可以将此订单视为付款成功->

 

    客户B跳转收银台调用【代收冻结】200元,使用【余额支付】->

    操作完成后,客户的可用余额减少200,冻结余额增加200(若是存钱罐账户将继续享受收益)->

    新浪异步推送订单交易状态为:PRE_AUTH_APPLY_SUCCESS,p2p程序可以将此订单视为付款成功->

 

    客户C跳转收银台调用【代收冻结】300元,使用【余额支付】->

    操作完成后,客户的可用余额减少300,冻结余额增加300(若是存钱罐账户将继续享受收益)->

    新浪异步推送订单交易状态为:PRE_AUTH_APPLY_SUCCESS,p2p程序可以将此订单视为付款成功->

    

 

    5天后,若标募集满,p2p程序调用【代收完成】接口->

    

    新浪异步推送订单交易TRADE_FINISHED,将上述A、B、C金额解冻并且收到【关联号可代付剩余资金】。

    注:TRADE_FINISHED是推送到【代收冻结的异步地址】中去,不会推到【代收完成的异步地址】中,全笔订单以代收冻结订单号为主线

 

    5天后,若流标,p2p程序调用【代收撤销】接口->

    

    新浪异步推送订单交易PRE_AUTH_CANCELED,将上述A、B、C金额解冻并且还原可用状态。

    注:PRE_AUTH_CANCELED是推送到【代收冻结的异步地址】中去,不会推到【代收完成的异步地址】中,全笔订单以代收冻结订单号为主线    

 

代收冻结注意事项:

        1.参数trade_close_time交易关闭时间,只管理客户付款时间,不参与代收完成的时间。

        2.代收冻结订单号必须保存好,不允许丢失。

 

代收完成注意事项:

        代收完成可以理解为将之前代收冻结的订单金额解冻并且收到【关联号可代付剩余资金

        1.只有代收冻结成功交易才能发起代收完成。代收完成【成功】只能有一次。

        2.如果代收冻结时:can_repay_on_failed为N,代收完成请求若失败,钱解冻还原为可用状态,代收完成请求只能有一次

        3.如果代收冻结时:can_repay_on_failed为Y,代收完成请求若失败,订单状态依然为处理中,可以再次发起代收完成。

        4.代收完成金额必须小于或等于代收冻结金额。

        5.如果当前订单正在代收完成处理中、已经代收完成成功、正在代收撤销处理中、已经代收撤销成功则不能发起代收完成。

 

代收撤销注意事项:

        代收撤销可以理解为将之前代收冻结的订单金额解冻并且还原到可用余额

        1.只有代收冻结成功交易才能发起代收撤销。

        2.代收撤销金额默认等于代收冻结金额。

        3.如果当前订单正在代收完成处理中、已经代收完成成功、正在代收撤销处理中、已经代收撤销成功则不能发起代收撤销。

 


  • 上一篇:代收参数can_repay_on_failed怎么用?
  • 下一篇:从平台账户扣款,或者付款给平台参数说明

与此文章相关还有:

like article