代付交易请求 - 易企通1.0

1.业务说明
发起实时代付请求。requestId每个渠道必须每天每次唯一，acceRetCode 返回000000表示交易成功，XXXXXX表示交易失败，XXXX61表示交易失败中的代付额度不足，其他返回码状态为中间状态，需发起查询确认结果。
2.加密相关：MAB
如下字段对应的内容按顺序拼接为初始MAB串
accountNo
requestId
stlmAmt

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json; charset=GBK

Body 参数application/json

tradeCode

string

请求码

必需

<= 6 字符

reqTime

string

请求时间戳

必需

请求时间戳（格式YYYYMMDDHH24MISS

<= 14 字符

deviceIp

string

请求设备ip

必需

<= 26 字符

channelId

string

请求渠道标识

必需

<= 25 字符

requestId

string

请求流水号

必需

请求流水号（和渠道标识唯一标识一个请求），纯数字

<= 25 字符

signStr

string

签名

必需

签名（data域数据为签名数据串）

<= 300 字符

data

object

附加信息

必需

附加信息

otherCode

string

第三方标识（分配的）

必需

第三方标识（分配的）

<= 23 字符

payDate

string

付款日期

必需

付款日期YYYYMMDD

<= 8 字符

accountNo

string

入账账号

必需

入账账号

<= 30 字符

accName

string

入账户号

必需

入账户号

<= 120 字符

accType

enum<string>

账户类型

必需

账户类型: 00 -- 个人帐户，10 -- 对公账户, FF -- 虚拟帐户

枚举值:

0010FF

cardKind

enum<string>

卡种（D借记卡，C信用卡,H合一卡，X未知）

必需

卡种（D借记卡，C信用卡,H合一卡，X未知）

枚举值:

DCHX

bankCode

string

开户行代码

必需

开户行代码

<= 20 字符

bankName

string

开户行名称

必需

开户行名称

<= 120 字符

stlmAmt

string

应代付金额（分）

必需

应代付金额（分）

<= 12 字符

amtType

enum<string>

交易方式（0：授信余额；1：资金余额/结算资金）

必需

交易方式（0：授信余额；1：资金余额/结算资金）

<= 1 字符

枚举值:

payFlag

enum<string>

业务类型（1转账；…）

必需

业务类型（1转账；…）

枚举值:

qztransChennl

string

出款渠道标识号

必需

出款渠道标识号

<= 25 字符

tradeAmt

string

代付对应的商户总交易金额（分）

可选

代付对应的商户总交易金额（分）

<= 12 字符

tradeFee

string

代付对应的商户总交易手续费（分）

可选

代付对应的商户总交易手续费（分），8位后清算按照D+8位处理，默认为D00000000（商户交易10000分，此字段上送D00000114：代表应收1.14手续费）

<= 12 字符

remarkDesc

string

代付备注信息

可选

代付备注信息

<= 50 字符

accPhone

string

入账通知手机号

可选

入账通知手机号

<= 20 字符

backUrl

string

如填写后端通道为异步的将会发起结果通知，不填不通知

可选

如填写后端通道为异步的将会发起结果通知，不填不通知

Otherfee

string

特殊计费

可选

殊计费（如押金，此金额为不可退金额）域描述：本域为多用法域，用于传递交易过程中的特殊费用信息；域格式：<用法个数n> <用法ID1> <用法ID1取值>……<用法IDn> <用法IDn取值>；用法ID ：定长1位，取值’A’~’Z’; 用法ID取值类别如下： —— A：交易过程中的押金信息； —— B：保留使用； —— C：保留使用；如：3A000000000001B00000000003C000000000011

orgsmercode

string

合作方平台系统的商户唯一标识

可选

合作方平台系统的商户唯一标识

<= 50 字符

settleflag

string

0/T1标志

可选

0/T1标志 0:T0 ; 1:T1

ConsumerSession

string

此笔代付对应的原消费流水号

可选

此笔代付对应的原消费流水号

<= 150 字符

示例

{
  "tradeCode": "string",
  "reqTime": "string",
  "deviceIp": "string",
  "channelId": "string",
  "requestId": "string",
  "signStr": "string",
  "data": {
    "otherCode": "string",
    "payDate": "string",
    "accountNo": "string",
    "accName": "string",
    "accType": "00",
    "cardKind": "D",
    "bankCode": "string",
    "bankName": "string",
    "stlmAmt": "string",
    "amtType": "0",
    "payFlag": "1",
    "qztransChennl": "string",
    "tradeAmt": "string",
    "tradeFee": "string",
    "remarkDesc": "string",
    "accPhone": "string",
    "backUrl": "string",
    "Otherfee": "string",
    "orgsmercode": "string",
    "settleflag": "string",
    "ConsumerSession": "string"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

tradeCode

string

请求码

必需

<= 6 字符

reqTime

string

请求时间戳

必需

请求时间戳（格式YYYYMMDDHH24MISS

<= 14 字符

channelId

string

请求渠道标识

必需

<= 25 字符

requestId

string

请求流水号

必需

请求流水号（和渠道标识唯一标识一个请求），纯数字

<= 25 字符

signStr

string

签名

必需

签名（data域数据为签名数据串）

<= 300 字符

acceRetCode

string

返回码

必需

返回码（000000表示代付成功,XXXXXX代付失败，其他：未知状态-需发起查询）

accRetMsg

string

返回信息

必需

返回信息

procTime

string

返回时间戳

必需

返回时间戳

data

object

附加信息

必需

附加信息

accountNo

string

入账账号

必需

入账账号

<= 30 字符

accName

string

入账户号

必需

入账户号

<= 120 字符

accType

enum<string>

账户类型

必需

账户类型: 00 -- 个人帐户，10 -- 对公账户, FF -- 虚拟帐户

枚举值:

0010FF

cardKind

enum<string>

卡种（D借记卡，C信用卡,H合一卡，X未知）

必需

卡种（D借记卡，C信用卡,H合一卡，X未知）

枚举值:

DCHX

bankCode

string

开户行代码

必需

开户行代码

<= 20 字符

bankName

string

开户行名称

必需

开户行名称

<= 120 字符

stlmAmt

string

应代付金额（分）

必需

应代付金额（分）

<= 12 字符

amtType

enum<string>

交易方式（0：授信余额；1：资金余额/结算资金）

必需

交易方式（0：授信余额；1：资金余额/结算资金）

<= 1 字符

枚举值:

channelWater

string

银行流水号

必需

银行流水号

<= 40 字符

recordId

string

平台代付流水号（对账用）

必需

平台代付流水号（对账用）

<= 20 字符

示例

{
  "tradeCode": "string",
  "reqTime": "string",
  "channelId": "string",
  "requestId": "string",
  "signStr": "string",
  "acceRetCode": "string",
  "accRetMsg": "string",
  "procTime": "string",
  "data": {
    "accountNo": "string",
    "accName": "string",
    "accType": "00",
    "cardKind": "D",
    "bankCode": "string",
    "bankName": "string",
    "stlmAmt": "string",
    "amtType": "0",
    "channelWater": "string",
    "recordId": "string"
  }
}