外部记账申请

POST/v1/accp/txn/transfer

商户通过该接口对交易进行非同名外部转账。可以通过记账结算/外部记账完成交易二次确认功能。

请求参数

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 字符

order_amount

number

订单总金额

必需

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

risk_item

string

风控参数

必需

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

fee_amount

number

商户代收手续费金额

可选

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

pay_time_type

enum<string>

到账类型

可选

枚举值:

TRANS_THIS_TIMETRANS_NORMALTRANS_NEXT_TIME

默认值:

TRANS_THIS_TIME

check_flag

enum<string>

审核标识

可选

枚举值:

默认值:

payer_info

object

必需

payer_id

string

付款方标识

可选

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

<= 40 字符

payer_type

enum<string>

付款方类型

必需

枚举值:

MCHUSER

payer_accttype

string

付款方账户类型

必需

USEROWN：用户自有可用账户。
MCHOWN：平台商户自有可用账户

password

string

支付密码

可选

<= 16 字符

random_key

string

密码随机因子key

可选

pap_agree_no

string

委托协议号

可选

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

payee_info

object

收款方信息

必需

bank_acct_type

string

收款方类型

必需

对私银行账户：BANKACCT_PRI 对公银行账户：BANKACCT_PUB

bank_acctno

string

银行账号

必需

bank_acctname

string

户名

必需

bank_code

string

银行编码

可选

8位银行编码，对公账户必输

cnaps_code

string

联行号

可选

12位联行号，对公账户必输

postscript

string

交易附言

可选

提现交易附言，单笔金额大于等于5w必须提供

<= 16 字符

txn_purpose

enum<string>

代发用途

可选

代发交易用途

枚举值:

其他

risk_info

string

风控信息

必需

风控参数字符串，以JSON格式透传，具体参考：

{
  "mch_id": "2020042200284052",
  "sub_mchid": "302210180000021525",
  "txn_seqno": "string",
  "txn_time": "2019-08-24T14:15:22.123Z",
  "pay_expire": 360,
  "notify_url": "string",
  "order_info": "string",
  "order_amount": 0,
  "risk_item": "string",
  "fee_amount": 0,
  "pay_time_type": "TRANS_THIS_TIME",
  "check_flag": "N",
  "payer_info": {
    "payer_id": "string",
    "payer_type": "MCH",
    "payer_accttype": "string",
    "password": "string",
    "random_key": "string",
    "pap_agree_no": "string"
  },
  "payee_info": {
    "bank_acct_type": "string",
    "bank_acctno": "string",
    "bank_acctname": "string",
    "bank_code": "string",
    "cnaps_code": "string",
    "postscript": "string",
    "txn_purpose": "其他"
  },
  "risk_info": "string"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

交易结果代码

必需

0000表示代发申请成功，最终代发处理结果以异步通知接口为准； 8889表示代发申请待确认成功，需要调用代发确认完成提现创单申请； 8888表示代发需要再次进行短信验证码校验

>= 4 字符<= 4 字符

ret_msg

string

交易结果描述

必需

<= 100 字符

mch_id

string

商户编号

必需

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

sub_mchid

string

子商户编号

可选

user_id

string

所属用户编号

必需

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

<= 40 字符

txn_seqno

string

商户系统唯一订单号

必需

<= 32 字符

order_amount

number

订单总金额

必需

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

fee_amount

number

手续费金额

必需

手续费金额，单位为元，精确到小数点后两位。

platform_txno

string

系统代发单号

必需

token

string

交易token

必需

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

未设置