协议申请

POST/v1/accp/txn/pap-agree-apply

用户发起对某个客户的余额委托交易的协议授权，唤起授权页面。

请求参数

Header 参数

timestamp

string

必需

时间戳，格式：yyyyMMddHHmmss，例如20250116142230

mch_id

string

商户编号

必需

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

<= 18 字符

示例值:

2020042200284052

sub_mchid

string | null

子商户编号

可选

子商户编号

<= 18 字符

示例值:

302210180000021525

txn_seqno

string

商户请求流水号

必需

商户系统唯一订单号

<= 32 字符

txn_time

string <date-time>

商户系统交易时间

必需

<= 14 字符

正则匹配:

YYYYMMDDH24MISS

user_id

string

所属用户编号

必需

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

<= 64 字符

flag_chnl

enum<string>

应用渠道

必需

目前只支持H5

枚举值:

ANDROIDIOSH5PC

return_url

string

交易完成回跳页面地址

可选

交易完成回跳页面地址，H5/PC渠道必传

<= 512 字符

notify_url

string

异步通知地址

必需

交易结果异步通知接收地址，建议HTTPS协议

<= 512 字符

papSignInfo

object

可选

sign_start_time

string

授权开始时间

可选

授权生效日期：yyyyMMdd（必须与结束时间成对出现）

正则匹配:

yyyyMMdd

sign_invalid_time

string

授权结束时间

可选

授权结束日期：yyyyMMdd（必须与开始时间成对出现）

正则匹配:

yyyyMMdd

single_limit

number

单笔限额

可选

委托代扣单笔最大交易额度

daily_limit

number

单日限额

可选

委托代扣每日最大交易额度

monthly_limit

number

单月限额

可选

委托代扣每月最大交易额度

agreement_type

enum<string>

免密协议类型

可选

免密协议类型。
WITH_HOLD：免密代扣
WITH_WITHDRAW：免密提现
注：若不填写，则默认为免密代扣。

枚举值:

WITH_HOLDWITH_WITHDRAW

默认值:

WITH_HOLD

{
    "mch_id": "2023071001518973",
    "txn_seqno": "`~!@#$%^&*()-_=+[{]}\\|;:\"',<.>/?",
    "txn_time": {% mock 'now', '', 'yyyyMMddHHmmss', '', '' %},
    "user_id": "20240129200324",
    "flag_chnl": "H5",
    "return_url": "http://10.19.17.15:8080/llpaytest/accpNotifyReceive_test.htm",
    "notify_url": "http://10.19.17.15:8080/llpaytest/accpNotifyReceive_test.htm",
    "papSignInfo": {
        "sign_start_time": "20241030",
        "sign_invalid_time": "20300101",
        "single_limit": "5",
        "daily_limit": "50",
        "monthly_limit": "500",
        "agreement_type": "WITH_HOLD"
    }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

交易结果代码

必需

见码表

>= 4 字符<= 4 字符

ret_msg

string

交易结果描述

必需

<= 100 字符

mch_id

string

商户编号

必需

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

<= 18 字符

sub_mchid

string

子商户编号

可选

user_id

string

所属用户编号

必需

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

<= 64 字符

txn_seqno

string

交易流水号

必需

商户系统唯一订单号

<= 32 字符

platform_txno

string

平台订单号

可选

连连订单唯一编号

<= 20 字符

gateway_url

string

网关地址

可选

协议签约网关地址，用户跳转至该地址完成签约过程

未设置