订单退款前商户回复确认退款结果

开发环境

http://dev-cn.your-api-server.com

POST

/v3/alipay/marketing/certificate/order/refundconfirmcommit

本地生活商品

公共错误码

业务错误码

状态码	错误码	错误描述	解决方案
400	SYSTEM_ERROR	系统繁忙	可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
400	INVALID_PARAMETER	参数有误,请检查参数	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
400	BIZ_ORDER_REFUND_SUCCESS	已经完成退款	已经完成退款，无需确认
400	CERTIFICATE_REFUND_CONFIRM_TIME_OUT	商户退款确认需在指定时间范围内应答	商户退款确认未在指定时间范围内应答，不能再确认退款
400	OPENAPI_SPI_FINISH_CONFIRM	商户已经完成退款确认，无需重复确认	商户已经完成退款确认，无需重复确认
400	ORDER_REFUND_COMFIRM_COMMIT_ERROR	退款前向商户确认退款异常,请进行重试	可能发生了网络或者系统异常，导致调用异常，商户可以用同样的请求发起重试。具体异常可能有下游超时，系统抖动

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/marketing/certificate/order/refundconfirmcommit' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
	"user_id":"2088xxxx",
	"certificate_id":"2016042700826004508401111111",
	"order_id":"2015042321001004720200028594",
	"result":"ACCEPT",
	"reason":"不符合退款条件:商家线下协商后已经退款",
	"code":"拒绝退款的三方码"
}'

响应示例

200 - 示例 1

{}

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

user_id

string

必需

【描述】买家的支付宝uid 【示例值】2088xxxx

certificate_id

string

必需

【描述】凭证标识ID。通过退款前向商户确认是否可以退款spi入参获取【示例值】2016042700826004508401111111

order_id

string

必需

【描述】订单号。通过退款前向商户确认是否可以退款spi入参获取【示例值】2015042321001004720200028594

result

string

必需

【描述】退款前向商户确认退款结果【枚举值】接受退款: ACCEPT 拒绝退款: REJECT 【示例值】ACCEPT

reason

string

必需

【描述】拒绝原因【示例值】不符合退款条件:商家线下协商后已经退款

code

string

可选

【描述】拒绝退款的三方码【示例值】拒绝退款的三方码

示例

返回响应

🟢200成功

application/json

Body

object {0}

🟠400请求有误

修改于 2023-11-22 02:08:22

撤销凭证核销状态

查询凭证信息

订单退款前商户回复确认退款结果

公共错误码#

业务错误码#

请求参数

返回响应

公共错误码

业务错误码