交易记账申请

POST/v1/accp/txn/payment-supplement

商户通过连连不支持的其他渠道（如POS刷卡，客户线下转账至平台实体账户等）成功交易后，可通过此接口通知系统上账，为指定的会员增加余额，并收取指定金额的手续费（如有）。
根据收款方资金是否可用，可用分为：

待结算余额记账；
可提现余额记账。

特点：

支持订单多收款方的记账，此时类似于合单支付，一个订单最多支持同时10个收款方；
支持订单的担保交易模式，此时收款方为担保确认时卖方，担保支付成功资金进入担保账户进行管控；
支持订单的分账模式，此时收款方必须为1个，且分账模式将资金冻结在收款方；
支持余额支付组合和优惠券组合；
若实际交易产生了多个付款方式，多个收款方式，则必须以担保形式处理。

请求参数

mch_id

string

商户编号

必需

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

<= 18 字符

示例值:

2020042200284052

sub_mchid

string | null

子商户编号

可选

子商户编号

<= 18 字符

示例值:

302210180000021525

user_id

string

所属用户编号

可选

交易发起人非商户时必填

<= 40 字符

txn_seqno

string

商户订单号

必需

商户系统唯一订单号

<= 32 字符

txn_time

string <date-time>

商户支付订单时间

必需

<= 14 字符

正则匹配:

YYYYMMDDH24MISS

busi_type

enum<string>

业务类型

必需

枚举值:

100001100002100099120001120002130001

notify_url

string

记账结果通知地址

可选

<= 255 字符

order_info

string

订单描述

可选

<= 255 字符

order_amount

number

订单总金额

必需

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

fee_amount

number

商户代收手续费金额

可选

手续费金额，单位为元，精确到小数点后两位。会自动收取到商户的自有资金账户。不允许超过MAX（订单总金额的20%，10）

coupon_amount

number

优惠券金额

可选

优惠券金额，单位为元，精确到小数点后两位

secured_flag

boolean

担保交易标识

可选

标识是否为担保交易，若是则需要进行担保确认。默认：false

默认值:

false

check_flag

boolean

二次确认标识

可选

是否需要余额支付确认，默认：false

默认值:

false

profit_sharing

boolean

分账标记

可选

标记该笔上账是否要分账，若分账则该笔资金会在收款方冻结。默认：false

默认值:

false

supplement_info

object

上账补充信息

必需

group_no

string

上账分组标记

必需

现阶段需要提前报备

is_available

boolean

是否上账可用资金

必需

支持交易可用上账，需要单独申请开通，默认：false
（暂不支持）

supplement_date

string <date>

上账外部账期

必需

上账所属外部账期用于控制资金清算核对，即它表示该笔交易资金所属外部账期。默认不填写，则为发生当日，该笔交易会参与隔日对账；若填写，则表示补指定某一天的交易，例如20210701补单少补了一笔，隔日发现对账不平后，通过指令可额外补0701的交易，不允许填写未来的日期。

默认值:

正则匹配:

yyyyMMdd

supplement_amount

number

上账金额

必需

order_amount=上账金额+余额支付金额+优惠券金额

balance_info

object

付款信息

可选

余额支付付款信息

user_id

string

用户唯一编号

可选

用户在商户系统中的唯一编号，需要包装mch_id+user_id唯一

<= 40 字符

user_type

enum<string>

用户类型

必需

枚举值:

MCHUSER

password

string

支付密码

可选

余额支付默认需要支付密码

random_key

string

密码随机因子key

可选

密码随机因子key，随机因子获取接口返回

pap_agree_no

string

委托协议号

可选

该字段需要RSA加密传输

balance_amount

number

余额支付金额

必需

order_amount=上账金额+余额支付金额+优惠券金额

payee_info

array [object {5}]

收款方信息

可选

对象数组，若收款方>1，则不再支持分账功能。注：该模式为合单支付模式，无主收款方概念。

>= 1 items<= 10 items

payee_id

string

收款方ID

可选

payee_type为USER时，必填。

<= 40 字符

payee_type

enum<string>

收款方类型

必需

枚举值:

MCHUSER

payee_accttype

enum<string>

收款方账户类型

必需

枚举值:

USEROWNMCHOWNMCHCOUPONMCHFEEUSERDEFINED

payee_amount

string

收款方金额

必需

payee_memo

string

收款方备注

可选

<= 255 字符

goods_info

object (goods_info)

商品信息

必需

对象格式

goods_id

string

商品编码

必需

<= 32 字符

goods_name

string

商品名称

可选

<= 64 字符

goods_category

string

商品类目

可选

<= 24 字符

goods_quantity

integer

商品数量

可选

goods_price

number

商品单价

可选

单位：元

goods_body

string

商品描述

可选

<= 64 字符

{
  "mch_id": "2020042200284052",
  "sub_mchid": "302210180000021525",
  "user_id": "string",
  "txn_seqno": "string",
  "txn_time": "2019-08-24T14:15:22.123Z",
  "busi_type": "100001",
  "notify_url": "string",
  "order_info ": "string",
  "order_amount": 0,
  "fee_amount": 0,
  "coupon_amount": 0,
  "secured_flag": false,
  "check_flag": false,
  "profit_sharing": false,
  "supplement_info": {
    "group_no": "string",
    "is_available": true,
    "supplement_date": "",
    "supplement_amount": 0
  },
  "balance_info": {
    "user_id": "string",
    "user_type": "MCH",
    "password": "string",
    "random_key": "string",
    "pap_agree_no": "string",
    "balance_amount": 0
  },
  "payee_info": [
    {
      "payee_id": "string",
      "payee_type": "MCH",
      "payee_accttype": "USEROWN",
      "payee_amount": "string",
      "payee_memo": "string"
    }
  ],
  "goods_info": {
    "goods_id": "string",
    "goods_name": "string",
    "goods_category": "string",
    "goods_quantity": 0,
    "goods_price": 0,
    "goods_body": "string"
  }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

交易结果代码

必需

0000表示交易记账成功，8888表示需要进行二次短信验证，8889表示需要记账确认

>= 4 字符<= 4 字符

ret_msg

string

交易结果描述

必需

<= 100 字符

mch_id

string

商户编号

必需

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

<= 18 字符

sub_mchid

string

子商户编号

可选

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

<= 18 字符

user_id

string

所属用户编号

必需

用户在商户系统中的唯一编号，需要包装mch_id+user_id唯一

<= 40 字符

txn_seqno

string

商户订单号

必需

商户系统唯一订单号

<= 32 字符

order_amount

number

订单总金额

必需

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

fee_amount

number

商户代收手续费金额

必需

手续费金额，单位为元，精确到小数点后两位。会自动收取到商户的自有资金账户。不允许超过MAX（订单总金额的20%，10）

platform_txno

object (平台订单号)

平台支付订单号

必需

连连订单唯一编号：如2011030900001098

platform_txno

string

平台订单号

可选

连连订单唯一编号

<= 20 字符

未设置