退款申请

POST/v1/ipay/refund

退款申请

请求参数

mch_id

string

商户编号

必需

商户编号是商户在平台上开设的商户号码，为18位数字

<= 18 字符

示例值:

201304121000001004

sub_mch_id

string | null

子商户编号

可选

子商户编号

<= 18 字符

示例值:

302210180000021525

refund_seqno

string

商户退款订单号

必需

商户系统唯一订单号

<= 64 字符

示例值:

SOgKCGouScflQDsTw6I8Nm11DzTZEn5n

refund_time

string <YYYYMMDDH24MISS>

商户退款订单时间

必需

格式：YYYYMMDDH24MISS 14位数字，精确到秒

<= 14 字符

示例值:

20231207134711

txn_seqno

string

商户支付订单号

必需

原交易支付订单号

<= 32 字符

示例值:

SOgKCGouScflQDsTw6I8Nm11DzTZEn5n

txn_date

string <YYYYMMDD> | null

交易日期

可选

交付交易发生日期，格式：YYYYMMDD

<= 8 字符

示例值:

20231207

refund_reason

string | null

退款原因描述

可选

用户填写退款原因

<= 1024 字符

refund_amount

string

退款金额

必需

退款金额，单位为RMB-元。
大于0的数字，精确到小数点后两位。
如：49.65。需要小于原支付订单可退款金额

<= 11 字符

示例值:

49.65

notify_url

string

结果通知地址

必需

支付平台在退款成功后通知商户服务端的地址

<= 255 字符

示例值:

https://test.lianlianpay-inc.com/llpaytest/mpspNotifyReceive_test.htm

quota_account_infos

array[object (额度账户对象) {2}] | null

额度账户退款时的额度账户信息

可选

额度账户退款时的额度账户信息

account_id

string | null

额度账户id

可选

amount

string | null

当前账户付款金额

可选

divide_refund_infos

array[object (原分账方退款信息) {2}]

分账方原退款信息

可选

对象格式，参考示例：分账收款方退款信息参数 PS:非订单分账无需上送

divide_uid

string

原分账方商户号

必需

<= 18 字符

divide_amount

number

分账方金额

必需

分账金额以元为单位

{
  "mch_id": "201304121000001004",
  "sub_mch_id": "302210180000021525",
  "refund_seqno": "SOgKCGouScflQDsTw6I8Nm11DzTZEn5n",
  "refund_time": "20231207134711",
  "txn_seqno": "SOgKCGouScflQDsTw6I8Nm11DzTZEn5n",
  "txn_date": "20231207",
  "refund_reason": "string",
  "refund_amount": "49.65",
  "notify_url": "https://test.lianlianpay-inc.com/llpaytest/mpspNotifyReceive_test.htm",
  "quota_account_infos": [
    {
      "account_id": "string",
      "amount": "string"
    }
  ],
  "divide_refund_infos": [
    {
      "divide_uid": "string",
      "divide_amount": 0
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

交易结果代码

必需

交易结果代码
0000 见返回码
8888 短信已下发，需要继续进行二次短信验证才能继续交易
可参考返回码列表
https://api-doc.lianlianpay.com/openplatform/doc-338978

示例值:

0000

ret_msg

string

交易结果描述

必需

交易结果描述

<= 100 字符

mch_id

string

商户编号

可选

商户编号，商户编号是商户在平台上开设的商户号码，为18位数字

<= 18 字符

示例值:

201304121000001004

refund_seqno

string

商户系统唯一订单号

可选

<= 32 字符

platform_refundno

string

平台退款订单号

可选

连连订单唯一编号

<= 18 字符

示例值:

2011030900001098

refund_amount

string

可选

该笔订单的资金总额，单位为RMB-元。
大于0的数字，精确到小数点后两位。
如：49.65

<= 8 字符

示例值:

49.65

{
  "ret_code": "",
  "ret_msg": "",
  "mch_id": "",
  "refund_seqno": "",
  "platform_refundno": "",
  "refund_amount": ""
}