记账结算申请

POST/v1/accp/txn/withdrawal

用户/平台商户将账户可用余额提现至开户绑定的银行账户，只能提现至同名银行账户中。
默认验证方式：支付密码+短信验证码。短信验证下发至注册绑定手机号。
【不支持法人提现】

请求参数

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

商户代收手续费金额

可选

手续费金额，单位为元，精确到小数点后两位。会自动收取到商户的自有资金账户。手续费不能超过订单金额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

付款方标识

必需

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

<= 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

object

收款方信息

必需

linked_acctno

string

绑定银行账号

可选

银行卡号必须在系统侧绑定过，提现时可指定具体的卡号或者对应的绑卡协议号，二者选其一提供。若两者都送,优先使用绑卡协议号

agreement_no

string

绑卡协议号

可选

个人用户可绑定多张银行卡，提现时可指定具体的卡号或者对应的绑卡协议号，二者选其一提供。若两者都送,优先使用绑卡协议号

postscript

string

交易附言

可选

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

<= 16 字符

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": {
    "linked_acctno": "string",
    "agreement_no": "string",
    "postscript": "string"
  },
  "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

所属用户编号

必需

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

<= 64 字符

txn_seqno

string

商户系统唯一订单号

必需

<= 32 字符

platform_txno

string

平台订单号

可选

连连订单唯一编号

<= 20 字符

order_amount

number

订单总金额

必需

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

fee_amount

number

商户代收手续费金额

必需

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

token

string

交易token

可选

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

未设置