亮色模式

Notify - 退款结果通知

POST

:::tip[]
连连全球收单在退款处理完成后，主动会向商家传入的notification_url地址发送退款结果通知，目前仅当退款状态 = “RS”时，才会触发退款结果通知。消息服务会根据响应报文判断商家系统是否已经成功处理消息，需要商家同步返回固定报文，消息服务则认为商户已经处理成功，停止发送；如果未返回固定报文内容，连连全球收单则认为消息投递失败，会根据投递重试策略重新发送消息至notification_url地址；

签名构建因子为入参列表中所有参数;
:::

投递重试策略

一般情况下，在订单支付成功后会实时投递第一次通知，后续每间隔10分钟触发一次重试，最多投递15次。

接口协议结构体

详情可查看请求与响应结构

请求参数

Header 参数

signature

string

签名

必需

示例值:

XJxQTCs1QTsp+Xo3iWrEMhMZUF9Wt+s2XTilT48lyv3zCmJS1+twA9cYsq9BHgTFn0FziCalU0OD3ddYWTRMf13uyLjwwOKD6LYwdC80+17FqAbBdeFCWuiA6ZUkXblWKiILACf8y0JKkpuEvXSSrvHcpS9MPakuXKKvOBRY1UXBWhXr2bL3qr84rbLU1Ka5ZU70j5r2xZv3JrdeFTYqBLss1/biXNT9bS45JFFoKwX/8ZoBKYhbYtn82b8QiO5I2YV2uw7VXukEGbtfR2p2O3479VGyR3+ch4qroWABRC52EjCwvV0Gbnzs6Wbw0Bg64/aR7GpNz9sHIy6Yw8KwZg==

timezone

string

时区

必需

示例值:

Asia/Hong_Kong

timestamp

string

必需

格式化时间戳,格式为：yyyyMMddHHmmss

示例值:

20211022160000

sign-type

string

加密方式

必需

示例值:

RSA

ll_transaction_id

string

连连全球收单订单号

必需

202112280336075

<= 64 字符

merchant_transaction_id

string

商户支付交易ID

必需

202112281523270200

<= 64 字符

original_transaction_id

string

原商户支付交易ID

必需

20200808000000008

<= 64 字符

refund_data

object (REFUNDRESPONSEREFUNDDATA)

退款数据

必需

refund_currency_code

string

退款币种

必需

通常情况下退款币种与支付币种相同

<= 3 字符

示例值:

USD

refund_amount

number

退款金额

必需

>= 0.01

示例值:

88.88

settlement_currency_code

string

结算币种

可选

<= 3 字符

示例值:

USD

settlement_amount

number

结算金额

可选

>= 0.01

示例值:

88.88

actual_refund_currency_code

string

实际退款币种

可选

<= 3 字符

示例值:

USD

actual_refund_amount

number

实际退款金额

可选

>= 0.01

示例值:

88.88

refund_status

string

退款状态

必需

详情可查看退款状态

<= 2 字符

示例值:

exchange_rate

number

退款汇率

可选

>= 0

refund_time

string

退款完成时间

可选

<= 14 字符

示例值:

20211228152354

reason

string

退款原因

可选

<= 512 字符

account_date

string

退款记账日期

可选

当退款成功时才返回

<= 8 字符

{
  "ll_transaction_id": "2022010406411871",
  "merchant_transaction_id": "test2022010110240583981",
  "original_transaction_id": "refund10167310",
  "refund_data": {
    "account_date": "20220104",
    "actual_refund_amount": "5599",
    "actual_refund_currency_code": "JPY",
    "reason": "do not like the goods",
    "refund_amount": "5599",
    "refund_currency_code": "JPY",
    "refund_status": "RS",
    "refund_time": "20220104180837",
    "settlement_currency_code": "USD"
  }
}
// NOTIFY_URL是商家在退款接口上送的退款结果通知地址

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

string

响应码

必需

固定返回：200

<= 32 字符

message

string

响应消息

必需

固定返回：success

<= 32 字符

// 商家通知响应为固定参数
{
  "code": "200",
  "message": "success",
}