教育缴费账单状态同步接口

isv向支付宝－中小学－教育缴费发送教育缴费账单后，家长在支付宝－中小学－教育缴费中对账单完成支付操作且支付成功，ISV在自有系统内容对账，完成后通过此接口同步对账后的账单状态。状态分为：缴费成功、缴费失败。

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/eco/edu/kt/billing/modify' \ --header 'Content-Type: application/json' \ --data-raw '{ "bank_success": "Y", "buyer_logon_id": "159****5620", "buyer_user_id": "2088101117955611", "buyer_user_open_id": "074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5", "fund_change": "Y", "out_request_no": "HZ01RF001", "out_trade_no": "20160101909909354354354", "refund_amount": "200.12", "refund_detail_item_list": "{\r\n\t\"fund_channel\":\"ALIPAYACCOUNT\",\r\n\t\"amount\":12.00,\r\n\t\"real_amount\":12.00\r\n\t\r\n}", "refund_reason": "正常退款", "status": "1", "trade_no": "2014112611001004680073956707", "gmt_refund": {} }'

请求参数

Body 参数application/json

bank_success

string

成功Y，失败N

可选

示例值:

buyer_logon_id

string

可选

退款时，支付宝返回的用户的登录id

示例值:

159****5620

buyer_user_id

string

可选

支付宝返回的买家支付宝用户id

示例值:

2088101117955611

buyer_user_open_id

string

可选

支付宝返回的买家支付宝用户id加密后信息

示例值:

074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5

fund_change

string

可选

本次退款是否发生了资金变化

示例值:

out_request_no

string

可选

标识一次退款请求，同一笔交易多次退款需要保证唯一，如需部分退款，则此参数必传。（若退款时填写，则同步退款状态时也必须填写）

示例值:

HZ01RF001

out_trade_no

string

isv系统的订单号

可选

示例值:

20160101909909354354354

refund_amount

string

可选

需要退款的金额，该金额不能大于订单金额,单位为元，支持两位小数

示例值:

200.12

refund_detail_item_list

string

可选

支付宝返回的退款资金渠道，json格式字符串

示例值:

{ "fund_channel":"ALIPAYACCOUNT", "amount":12.00, "real_amount":12.00 }

refund_reason

string

可选

退款原因，商家根据客户实际退款原因填写（若退款时填写，则同步退款状态时也必须填写）

示例值:

正常退款

status

string

可选

状态：1:缴费成功，2:关闭账单，3、退费如果为退款状态，需要填写fund_change, refund_amount, refund_reason, out_request_no, buyer_logon_id, gmt_refund, buyer_user_id, refund_detail_item_list; 4、同步网商返回的状态,如果是网商银行的账单，bank_success这个字段必填

示例值:

trade_no

string

支付宝返回的交易号

可选

示例值:

2014112611001004680073956707

gmt_refund

string

可选

支付宝返回的退款时间，而不是商户退款申请的时间

示例值:

{}

示例

教育缴费账单状态同步接口

请求参数

返回响应