内部记账申请

POST/v1/accp/txn/inner-transfer

内部记账：用户/平台商户A将账户可用余额代发至用户/平台商户B可用余额账户，业务场景为佣金代发、红包奖励代发、供应商货款付款等。

请求参数

mch_id

string

商户编号

必需

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

<= 18 字符

示例值:

2020042200284052

sub_mchid

string | null

子商户编号

可选

子商户编号

<= 18 字符

示例值:

302210180000021525

txn_seqno

string

商户订单号

必需

商户系统唯一订单号

<= 32 字符

txn_time

string <date-time>

商户支付订单时间

必需

<= 14 字符

正则匹配:

YYYYMMDDH24MISS

pay_expire

integer

订单有效时间

可选

订单有效期，逾期将会关闭交易单位：分钟，默认：3天
注：确认有效时间，超期将关单

默认值:

360

notify_url

string

提现结果通知地址

可选

<= 255 字符

order_info

string

订单描述

可选

<= 255 字符

txn_purpose

string

代发交易用途

可选

服务费信息费修理费佣金支付贷款支付其他不支持特殊字符

<= 256 字符

order_amount

number

订单总金额

必需

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

risk_item

string

风控参数

必需

要求上传的风控参数信息。JSON类型，具体上传内容可询问技术支持。

directionalpay_flag

enum<string>

定向支付标识

可选

标识该笔代发交易是否是约定收款方的定向支付，默认：N Y：定向支付 N：普通支付

枚举值:

payer_info

object

必需

payer_id

string

付款方标识

必需

用户在商户系统中的唯一编号

<= 64 字符

payer_type

enum<string>

付款方类型

必需

枚举值:

MCHUSER

payer_accttype

string

付款方账户类型

必需

只支持
USEROWN
MCHOWN

password

string

支付密码

可选

<= 16 字符

random_key

string

密码随机因子key

可选

pap_agree_no

string

委托协议号

可选

免密提现/代发时需要，通过用户委托授权协议申请接口获取，该字段需要连连RSA公钥加密传输。

payee_info

array [object {4}]

收款方信息

可选

内部代发支持一次性指定多个收款方（上限 10）
收款总金额必须和订单总金额相等

>= 1 items<= 10 items

payee_id

string

收款方ID

必需

payee_type为USER时，必填。

<= 64 字符

payee_type

enum<string>

收款方类型

必需

枚举值:

MCHUSER

payee_accttype

enum<string>

收款方账户类型

必需

只支持 USEROWN MCHOWN

枚举值:

USEROWNMCHOWNMCHCOUPONMCHFEEUSERDEFINED

payee_amount

string

收款方金额

必需

risk_info

string

风控信息

必需

上传ip_addr 用户操作IP

{
    "mch_id": "2020042300285003",
    "sub_mchid": "20240330221103",
    "txn_seqno": "{% mock 'integer', 1000000000000, 9999999999999 %}",
    "txn_time": {% mock 'now', '', 'yyyyMMddHHmmss', '', '' %},
    "pay_expire": 360,
    "notify_url": "www.xiamyinner.com",
    "order_info": "xiamy自测",
    "directionalpay_flag":"",
    "txn_purpose": "string",
    "order_amount": 100000,
    "payer_info": {
        "payer_id": "2020042200284052",
        "payer_type": "MCH",
        "payer_accttype": "MCHOWN",
        "password": "",
        "random_key": "1234556",
        "pap_agree_no": ""
    },
    "payee_info": [
        {
            "payee_id": "202506113132131",
            "payee_type": "USER",
            "payee_accttype": "USEROWN",
            "payee_amount": 3
        }
    ],
     "risk_info": {
        "ip_addr": "192.168.110.28"
      }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

交易结果代码

必需

0000表示代发申请成功，最终代发处理结果以异步通知接口为准； 8888表示代发需要再次进行短信验证码校验

>= 4 字符<= 4 字符

ret_msg

string

交易结果描述

必需

<= 100 字符

mch_id

string

商户编号

必需

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

sub_mchid

string

子商户编号

可选

user_id

string

所属用户编号

必需

用户在商户系统中的唯一编号

<= 64 字符

txn_seqno

string

商户系统唯一订单号

必需

<= 32 字符

order_amount

number

订单总金额

必需

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

platform_txno

object (平台订单号)

系统代发单号

必需

platform_txno

string

平台订单号

可选

连连订单唯一编号

<= 20 字符

token

string

交易token

必需

付授权令牌，当交易需要二次验证时，需要通过token调用《交易二次短信验证接口》

account_date

string <date>

账务日期

必需

ACCP系统交易账务日期，交易成功时返回

>= 8 字符<= 8 字符

正则匹配:

YYYYMMDD

未设置