本地生活商品
本地生活商品
公共请求参数
业务请求参数
order_id｜订单号必选string[1,64]
【描述】订单号。通过退款前向商户确认是否可以退款spi入参获取
【示例值】2015042321001004720200028594
result｜退款前向商户确认退款结果必选string[0,32]
【描述】退款前向商户确认退款结果
【枚举值】
接受退款: accept
拒绝退款: reject
【示例值】accept
reason｜拒绝原因必选string[0,256]
【描述】拒绝原因
【示例值】不符合退款条件:商家线下协商后已经退款
以下参数 二选一 传入
user_id｜买家的支付宝uidstring[1,32]
【描述】买家的支付宝uid
新商户建议使用user_open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用user_open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。
【示例值】2088xxxx
user_open_id｜买家的支付宝openidstring[1,128]
【描述】买家的支付宝openid 详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.certificate.order.refundconfirmcommit&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"result":"accept",
"reason":"不符合退款条件:商家线下协商后已经退款",
"user_id":"2088xxxx",
"user_open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
"order_id":"2015042321001004720200028594"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_marketing_certificate_order_refundconfirmcommit_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误,请检查参数 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| biz_order_refund_success | 已经完成退款 | 已经完成退款，无需确认 |
| certificate_refund_confirm_time_out | 商户退款确认需在指定时间范围内应答 | 商户退款确认未在指定时间范围内应答，不能再确认退款 |
| openapi_spi_finish_confirm | 商户已经完成退款确认，无需重复确认 | 商户已经完成退款确认，无需重复确认 |
| order_refund_comfirm_commit_error | 退款前向商户确认退款异常,请进行重试 | 可能发生了网络或者系统异常，导致调用异常，商户可以用同样的请求发起重试。具体异常可能有下游超时，系统抖动 |
| time_out_exception | 调用超时 | 调用超时，请求可能成功也可能失败，请以相同的请求发起重试 |