连连开放平台文档

分期退款申请

POST/v1/creditpay/refund/apply

生产地址：https://openapi.lianlianpay.com/mch/v1/creditpay/refund/apply
测试地址：https://openapi-test2.lianlianpay-inc.com/mch/v1/creditpay/refund/apply

请求参数

mch_id

string

商户编号

必需

商户编号是商户在连连支付支付平台上开设的商户号码，为18位数字，如：201304121000001004

正则匹配:

^\d{16,18}$

refund_time

string

商户退款订单时间

必需

退款订单执行时间，格式：YYYYMMDDH24MISS 14位数字，精确到秒

refund_seqno

string

商户退款订单唯一号

必需

商户系统中的唯一退款订单号

txn_seqno

string

商户原支付订单唯一号

必需

商户系统原支付唯一订单号

refund_reason

string

退款原因描述

可选

用户填写退款原因

<= 1024 字符

refund_amount

string

退款金额

必需

退款金额(仅支持全额退款)，单位为RMB-元。大于0的数字，精确到小数点后两位。如：49.65。

notify_url

string

异步通知地址

必需

支付平台在用户退款成功后通知商户服务端的地址，如： http://test.yintong.com.cn/help/notify.php

<= 255 字符

share_info

object (分账信息)

分账信息

可选

见：分账方信息详情

share_flag

string | null

分账标识

可选

IMMEDIATE-即时分账
DELAY-延迟分账
注：默认即时分账；当上送标识为延迟分
账，分账列表和分账类型可为空；

<= 16 字符

示例值:

IMMEDIATE

share_type

string | null

分账类型

可选

PERCENT-百分比
FIXED-固定金额
默认固定金额

<= 16 字符

示例值:

FIXED

share_list

array[object (分账方信息(分期)) {4}] | null

分账列表信息

可选

{
  "mch_id": "string",
  "refund_time": "string",
  "refund_seqno": "string",
  "txn_seqno": "string",
  "refund_reason": "string",
  "refund_amount": "string",
  "notify_url": "string",
  "share_info": {
    "share_flag": "IMMEDIATE",
    "share_type": "FIXED",
    "share_list": [
      {
        "share_uid": "分账方用户 id",
        "share_amount": "分账方金额",
        "share_percent": "分账比例",
        "share_memo": "分账说明"
      }
    ]
  }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: Rawtext/plain

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