更新时间：2024-11-11 14:25:50收藏我的文档设置返回文档在日常交易变动中，买家购买商品后，对商品进行退货、取消服务等操作，会涉及到给用户退款等操作。根据退款的方式，可分为支付宝商家平台进行退款和通过交易退款接口退款。退款方式通过支付宝商家平台退款选择 ，根据相对应的交易选择点击 退款 按钮。商家中的相关数据信息，建议可联系 4007585858。通过交易退款接口退款目前市面上大部分使用的都是 openapi 的产品，历史产品目前无法开通使用。本文阐述的接口就是 alipay.trade.refund（统一收单交易退款接口）。在买家付款成功后，商家调用接口退款，无需输入支付密码。在接口中设置退款交易号、退款金额等信息即可，判断退款是否成功，建议参考 如何判断退款成功。说明：如果要实现部分退款，则 out_requse_no 参数必传。退款接口关键参数字段说明参数名称是否必传参数说明out_trade_no特殊可选订单支付时传入的商户订单号，与支付接口设置的 out_trade_no 保持一致。注意：out_trade_no 和 trade_no 不能同时为空，若同时设置以 trade_no 为准。trade_no特殊可选支付宝交易号，订单创建后返回，可通过 alipay.trade.query（统一收单交易查询）接口查询。注意：out_trade_no 和 trade_no 不能同时为空，若同时设置以 trade_no 为准。out_request_no特殊可选标识一次退款请求，同一笔交易多次退款需要保证唯一，不重复。注意：如需部分退款，则此参数必传。refund_amount是需要退款的金额，该金额不能大于订单金额，单位为元，支持两位小数。注意：若是只退分账不退款，refund_amount=0。refund_reason否退款的原因说明 refund_royalty_parameters否退分账明细信息，用于退分账等，若只退款，不退分账可不设置。●普通模式退商家分账，可同时设置支出方和收入方账号。●互联网直付通退分账，只支持设置支出方账号。●互联网直付通退营销补差，只支持设置收入方账号。└royalty_type特殊可选分账类型。●普通分账：transfer●补差：replenish●为空默认为分账 transfer└trans_out_type是支出方账号类型。●userid：支付宝账号对应的支付宝唯一用户号。●loginname：支付宝登录号。└trans_out是支出方账号。●trans_out_type=userid：为 2088 开头的的支付宝唯一用户号。●trans_out_type=loginname：支出方的支付宝登录号。└trans_in_type否收入方账号类型。●userid：支付宝账号对应的支付宝唯一用户号。●cardaliasno：卡编号。一般为互联网直付通设置结算账号为银行卡返回信息，但建议设置默认结算账号为支付宝账号。●loginname：支付宝登录号。└trans_in否收入方账号。●trans_in_type=userid：2088 开头的的支付宝唯一用户号。●trans_in_type=cardaliasno：收入方在支付宝绑定的卡编号。●trans_in_type=loginname：收入方的支付宝登录号。└amount否退分账的金额，单位为元。└amount_percentage否分账信息中分账百分比。注意：只支持设置 amount_percentage=100，不支持其它数据。└desc否分账描述。退款有效期退款有效期实际是根据交易状态进行判断，只要交易状态 trade_status=trade_success（交易支付成功）就可进行退款。以下状态都不支持退款：●trade_status=wait_buyer_pay（交易创建，等待买家付款）●trade_closed（未付款交易超时关闭，或支付完成后全额退款）●trade_finished（交易结束，不可退款）说明：当面付、手机网站支付、电脑网站支付、app 支付退款有效期默认 12 个月。商家开通时可能由于开通协议不同或者其它原因，导致退款有效期不同，具体可退款时间建议联系商家客服。请到 在线咨询或拨打商家服务热线 4007585858 咨询，服务时间为 8:00-24:00。退款权限退款需要什么权限支付宝商家平台进行退款可联系 4007585858 了解。交易退款接口退款需注意，alipay.trade.refund (统一收单交易退款接口) 是支付接口的辅助接口，其接口权限应包含在开通的支付产品中，无需单独开通。是否有退款接口的权限，只需查看是否有开通过支付产品（当面付、app 支付、手机网站支付、电脑网站支付等），开通成功后在 appid 下绑定对应的产品（如当面付等），就可以使用 appid 调用退款接口测试。接口开通和查询权限流程可在 > 签约管理 中查看签约的支付产品。如果未签约，可具体查看如何开通流程。注意事项默认 12 个月是指 360 天还是自然月？该问题由于协议不同，需联系商家客服查询才可具体了解自己签约协议的退款期限。如何限制退款目前根据接口接入流程，无任何参数、渠道限制退款。限制账号只能调用支付接口，不能调用退款接口，只能根据业务方面判断是否有渠道限制：●请联系商家客服咨询是否可在业务方面限制无法进行退款操作；●关闭支付宝账号的支付总开关，但该功能关闭后会导致只要涉及资金出账都无法实现。如退款、转账、分账等资金支出渠道均无法使用。具体问题请到在线咨询或拨打商家服务热线 4007585858 咨询，服务时间为 8:00-24:00。
