3. 扣款接口

说明

• 商户代扣扣款接口

请求URL

• /api/jt/direct/debit/pay

请求方式

• POST

请求头

参数名	必选	类型	说明
Content-Type	是	string	application/json

请求体参数

参数名	必填	类型	说明
appId	是	string	应用APPID
appName	是	string	商户对接应用名称, 格式：字母+空格，1-100位
timestamp	是	long	当前时间戳（毫秒）
mchOrderId	是	string(1-32)	商户订单，格式：字母+数字，1-32位
amount	是	int	收款金额（单位为分）
channelCode	是	string	平台收单渠道代码
payToken	是	string	代扣Token
customerName	否	string(1-128)	付款人姓名
email	否	string(1-128)	付款人邮箱
mobile	否	string(11)	付款人电话(09开头的11位数字)
callbackUrl	是	string(1-256)	商户交易通知URL
remark	否	string(1-256)	收单备注
sign	是	string	签名，参考签名算法

请求体示例

{
  "appId": "f90addc4861540ef9312e87d8f360e08",
  "appName": "Merchant App",
  "timestamp": 1704067200000,
  "mchOrderId": "DD20240101120000",
  "amount": 10000,
  "channelCode": "JTWALLET_DIRECT_DEBIT",
  "payToken": "tok_abcdef1234567890",
  "customerName": "John Doe",
  "email": "johndoe@example.com",
  "mobile": "09123456789",
  "callbackUrl": "https://merchant.com/notify/direct-debit",
  "remark": "Monthly subscription payment",
  "sign": "EJeMHGDlLu3DdbIK/52aID1soLrD0rfGcEEsAQ8cXFWaXQHioVwfZUD82U5g67NTXP/F/0Mhg6bK7n6rJlC/clYzqZ1kHmO2FbCdujw0ATY+FfM6VkgVT4pXr1jYmg3Xe23RDqhFvkDcOfRvaGPtnf64yrQG32MZps23TsbnafitDbtfqSoDIZkDCw1j1EH3Shhd64xKh9L3O8ivyF2UDOiHSAD8+18JXOxMWMFcR01STKE5B+zlEu5OA98+ClDBdroekBVKDeBeagwwQr+0zDFUvAb+2QIPKA2o0JM3ooituiaKVCgCVfndNjk8wIzKz2QYp+RhjVOC/u+8+Yoqb4KoWjGkMXgDbM1GZpdHG/BmzqXqhnNF0Y0LYS4bkITstlOm30nnHSljT5bxjk2Sq1hp9259SqMdp52OyoznxbRwEva5Wk5YPo+zD8IHOctEjkwWXz9/jo2evK6QcWCOH2LM6cG7EoP6Cg+5P2AUTofSMZsn/ZnAy6h9MXIuirDBiujrKMk85EY74s8i7yCNmjQ5NRbPbKsNTJbkxp2cRSMPzYPzOXXqEgKMmYzVQ5SSAcqFZIj2fAOL/3fG+2aEMn/8AFjJuD3/160BmYCZbAY4A2LJow6SGP/OcifvWPwoziJv0IP5Jff59w0mv6h0+3HnJg5YAcqK7dani1C0cAQ="
}

响应参数

参数名	类型	说明
code	integer	响应码
message	string	响应信息
data	Object	数据

data参数

字段	类型	说明
mchOrderId	string	商户订单号
transactionId	string	交易流水号
transactionStatus	string	交易状态（如 PENDING）
channelType	string	支付渠道类型（如 DIRECT_DEBIT）
channelCode	string	渠道代码（如 JTWALLET_DIRECT_DEBIT）

响应示例

{
  "code": 10000,
  "message": "Success",
  "data": {
    "mchOrderId": "DD20240101120000",
    "transactionId": "TXN20240101120000123456",
    "transactionStatus": "PENDING",
    "channelType": "DIRECT_DEBIT",
    "channelCode": "JTWALLET_DIRECT_DEBIT"
  }
}

响应失败案例 响应code列表

{
  "code": 1002,
  "message": "merchant white ip forbidden"
}