wordpress 发布网站,求大神帮忙做网站,如何选择wordpress主题,做兼职的网站都有哪些工作有很多老板问小编#xff1a;“这个分账功能好是好#xff0c;也能搞定项目中的二清问题和税务纠纷#xff0c;但还是太复杂了#xff0c;每次要添加被分账对象都需要提交材料进行审核#xff0c;太繁琐了#xff0c;有没有更方便快捷的支付产品来解决资金问题#xff1… 有很多老板问小编“这个分账功能好是好也能搞定项目中的二清问题和税务纠纷但还是太复杂了每次要添加被分账对象都需要提交材料进行审核太繁琐了有没有更方便快捷的支付产品来解决资金问题” 那当然是有的现在我们牛卡派推出了代收代付的支付功能老板们只需要在后台添加姓名、银行卡和开户行无需审核即可输入具体的金额代发到其银行卡中操作简单快捷与分账不同分账操作是根据每笔交易来进行下发资金代收代付不按照比例分账而是将具体的金额下发。
1.产品说明
1.1产品简介
三方支付机构的批量代付产品用于商户向银行账户提出多笔转账交易。
1.2产品协议说明
支付请求是HTTP 协议请求商户以POST 方式Content-type 为application/json发送到后台网站中。此接口文档统一使用utf-8 编码方式。请求参数列表中有必填/选填项注意填写必填项。参数名称和参数说明中规定的固定值必须与列表中完全一致大小写敏感除hmac参数值外。
2数据交互
1.构造请求数据
商户根据支付机构提供的接口规则通过程序生成得到签名结果及要传输给支付机构的数据集合。
2.发送请求数据
把构造完成的数据集合通过以JSON 的数据格式请求支付机构。
3.对请求数据进行处理
支付机构得到这些集合后会先进行安全校验等验证一系列验证通过后便会处理这次发送过来的数据请求。
4.返回处理的结果数据
对于处理完成的交易支付机构会以两种方式把数据反馈给商户网站。程序上自动进行重新构造URL 地址链接在用户当前页面上通过自动跳转的方式跳回商户在请求时设定好的页面路径地址。
5.对返回数据进行处理
商户收到支付机构返回的结果数据后可以结合自身网站的业务逻辑对数据进行处理。
3.接口说明
3.1单笔代付接口
3.1.1业务功能
通过此接口商户可以付款到指定银行卡账户。
3.1.2交互模式
后台系统调用交互模式。
3.1.3请求参数列表 参数名称 参数含义 说明 数据类型 是否必填 签名顺序 userNo 商户编号 商户编号和商户密钥在商户后台获取 String 是 1 tradeMerchantNo 报备商户号 报备商户号 String 否 2 productCode 产品类型 产品类型 String 是 3 requestTime 交易请求时间 格式yyyy-MM-dd HH:mm:ss 如2018-05-28 18:00:00 String 是 4 merchantOrderNo 商户订单号 全局唯一由数字或字母组成长度须控制在 12 到 25 之间可包含边界 值 String 是 5 receiverAccountNo Enc 收款账户号 收款人银行卡卡号 String 是 6 receiverNameEnc 收款人 收款人银行卡持卡人名称 String 是 7 receiverAccountTyp e 账户类型 对私账户201 对公账户204 Integer 是 8 receiverBankChann elNo 收款账户联行号 对公账户必须填写此字段 String 否 9 paidAmount 交易金额 单位元精确到分保留两位小数。 BigDec imal 是 10 currency 币种 人民币币种填写201 String 是 11 isChecked 是否复核 复核201不复核202 (见注释 一) String 是 12 paidDesc 代付说明 填写此次单笔代付的代付说明长度 为 30 个字符以内 String 是 13 paidUse 代付用途 代付用途 String 是 14 callbackUrl 商户通知地址 代付完成后异步回调通知地址 String 否 15 firstProductCode 优先使用产品 组合付必填非组合付不用填写 String 否 16 hmac 签名数据 String 是 注释一是否审核→填写为201 时需到商户后台进行审核审核通过支付机构才会进行打款审核不通过则订单状态为订单已取消没有异步填写为202 时不需要到商户后台进行审核订单提交支付机构成功则开始打款。代付金额单位元精确到分保留两位小数。例如10.23注释二产品类型普通代付在工作日9:00-17:30 出款使用“可取余额”正常2 小时内到账建议在17:00 前提交并在商户后台审核订单
请求报文案例
{
userNo: 888100000004182,
productCode: BANK_PAY_ORDINARY_ORDER,
hmac: A5FFC45489254A0438D27628F346EC2C,
requestTime: 2018-05-28 14:10:10,
merchantOrderNo: 300000000001,
receiverAccountNoEnc: 6225882010007926,
receiverNameEnc: 支付机构,
receiverAccountType: 201,
receiverBankChannelNo: ,
paidAmount: 1.00,
currency: 201,
isChecked: 202,
paidDesc: 工资发放,
paidUse: 201,
callbackUrl:http://10.10.10.10:8080/pay/merchantCallback
}3.1.4应答参数列表 参数名称 中文名称 说明 数据类型 是否必填 签名顺序 statusCode 应答码 请求响应的应答码 String 是 1 message 应答信息 请求响应的应答码信息描述 String 是 2 data 应答数据 见应答数据域 json 字符串 是 应答信息域(data) errorCode 错误码 受理失败、受理中会在应答中返回错误码 String 否 3 errorDesc 错误描述 受理失败、受理中会在应答中返回错误码 String 否 4 userNo 商户编号 商户在支付平台系统的唯一身份标识 String 是 5 merchantOrderN o 商户订单号 全局唯一性由商户生成并在发起代付 请求的时候传入 String 是 6 hmac 签名数据 String 是
应答报文案例
{
statusCode: 2001,
message: 受理成功,
data: {
errorCode: ,
errorDesc: ,
userNo: 888100000002985,
merchantOrderNo: 3000000000001,
hmac: B326EF80B13649C15415C19748FA78D7
}
}
注响应数据的顺序不代表签名的顺序签名顺序请查阅文档的表格所对应的顺序。
3.1.5异步通知参数列表
交易成功或交易失败时异步通知以POST 请求方式返回Json 数据。如若通知响应statusCode 为 2001则我司系统将进行补发通知补发频率为5, 20, 60, 120, 180, 240s。
接入方对异步通知需要作幂等处理 参数名称 中文名称 说明 数据类型 是否 必填 签名顺 序 status 交易状态 代付明细的交易状态 Integer 是 1 errorCode 错误码 交易失败对应错误码 String 否 2 errorCodeDesc 错误描述 交易失败对应错误码描述 String 否 3 userNo 商户编号 商户在支付平台系统的唯一身份标识。 String 是 4 tradeMerchantNo 报备商户号 报备商户号 String 否 5 merchantOrderNo 商户订单号 全局唯一性由商户生成并在发起 代付请求的时候传入 String 是 6 platformSerialNo 平台流水号 全局唯一性成功受理商户的代付 请求时生成的流水号 String 是 7 receiverAccountNoEn c 收款账户号 收款账户号 String 是 8 receiverNameEnc 收款人 收款人信息 String 是 9 paidAmount 交易金额 交易金额 BigDecimal 是 10 fee 手续费 计算受理成功的订单所需额外支付 的费用 BigDecimal 是 11 completeTime 完成时间 代付完成时间格式yyyy-MM-dd HH:mm:ss 默认不返回如果有此参数需求请 联系支付机构客服。 String 否 12 hmac 签名数据 String 是
返回报文案例
{
fee: 0.11,
merchantOrderNo: 130000000006,
paidAmount: 52.00,
platformSerialNo: 30032018052900031256,
receiverAccountNoEnc: 6225882010007926,
receiverNameEnc: 支付机构,
status: 205,
userNo: 888100000002020
hmac:XXXXX
}
注响应数据的顺序不代表签名的顺序签名顺序请查阅文档的表格所对应的顺序
3.1.6商户返回确认信息 参数名称 中文名称 说明 数据类型 是否必 填 签名顺序 statusCode 应答码 商户回调通知后返回的应答码 String 是 1 message 应答信息 商户接收回调通知后处理失 败返回的错误描述 String 否 2
应答报文案例
{
statusCode: 2001,
message: 成功
}
3.2单笔代付查询接口
3.2.1请求参数列表
注请求返回交易状态未知时需要调用查询接口核实订单状态! 仅能查询15 天内的订单。 参数名称 中文名称 说明 数据类型 是否 必填 签名 顺序 userNo 商户编号 商户在支付平台系统的唯一身份标识。 String 是 1 merchantOrderNo 商户订单号 全局唯一由数字或字母组成长度须控制在 12 到 25 之间可包含边界值 String 是 2 hmac 签名数据 String 是 请求报文案例
{
userNo: 888100000004182,
merchantOrderNo: 880000000001,
hmac: 81D3430BF3E4A1D05958FE99FB5434A4
}
3.2.2应答参数列表 参数名称 中文名称 说明 数据类型 是否必填 签名 顺序 statusCode 应答码 请求响应的应答码 String 是 1 message 应答信息 请求响应的应答码信息描述 String 是 2 data 应答数据 见应答信息域应答信息域对象转成 json 字符串 json 字符串 是 应答信息域 status 状态 单笔代付查询请求的交易状态 Integer 是 3 errorCode 错误码 交易失败返回错误码 String 否 4 errorDesc 错误描述 受理失败、受理中会在应答中返回描述 String 否 5 userNo 商户号 商户在支付平台系统的唯一身份标识。 String 是 6 tradeMerchantN o 报备商户号 报备商户号 String 否 7 merchantOrder No 商户订单号 全局唯一性由商户生成并在发起代付请 求的时候传入 String 是 8 platformSerialN o 平台流水号 全局唯一性成功受理商户的代付请求时 生成的流水号 String 是 9 receiverAccount NoEnc 收款账户号 收款账户号信息 String 是 10 receiverNameEn c 收款人 收款人信息 String 是 11 paidAmount 交易金额 交易金额 BigDecimal 是 12 fee 手续费 计算受理成功的订单在该次代付交易中所 需额外支付的费用。 BigDecimal 否 13 completeTime 完成时间 代付完成时间,交易成功或失败时返回 默认不返回如果有此参数需求联系客服 String 否 14 hmac 签名数据 String 是 应答报文成功案例
{
statusCode: 2001,
message: 受理成功,
data: {
status: 203,
errorCode: ,
errorDesc: ,
userNo: 888100000004182,
merchantOrderNo: 880000000001,
platformSerialNo: 30032018052900031237,
receiverAccountNoEnc: 6225882010007926,
receiverNameEnc: 支付机构,
paidAmount: 1.00,
fee: 0.11
hmac: 81D3430BF3E4A1D05958FE99FB5434A4
}
}
应答报文订单不存在报文
{
statusCode: 2001,
message: 受理成功,
data: {
status: 214,
errorCode: 300002014,
errorDesc: 订单记录不存在,
userNo: 888100000002720,
merchantOrderNo: 8800eee00000001,
platformSerialNo: ,
receiverAccountNoEnc: ,
receiverNameEnc: ,
paidAmount: ,
fee: ,
hmac: 57396ca5bc0c1b6834f61bcb04bf0af2
}
}
3.3批量代付接口
3.3.1请求参数列表 参数名称 中文名称 说明 数据类型 是否 必填 签名 顺序 userNo 商户编号 商户在支付平台系统的唯一身份标识。 String 是 1 productCode 产品类型 产品类型 String 是 2 merchantBatchN o 商户批次号 全局唯一由数字或字母组成长度须控 制在 12 到 25 之间可包含边界值 String 是 3 requestCount 请求总笔数 须商户传入请求代付的总笔数核计 Integer 是 4 requestAmount 请求总金额 须商户传入请求代付的总金额核计 BigDecima l 是 5 requestTime 交易请求时间 格式yyyy-MM-dd HH:mm:ss 如2018-05-28 18:00:00 String 是 6 callbackUrl 商户通知地址 支付机构处理完请求后处理结果页面跳 转到商户网站里指定的 http 地址。 String 否 7 firstProductCod e 优先使用产品 组合付必填非组合付不用填写 String 否 8 details 代付明细数据 代付明细数据见子域子域 List 转成json 字符串 json 字符 串 是 代付明细数据域 userNo 商户编号 商户入网后生成的数字字符串 String 是 9 tradeMerchantN o 报备商户号 报备商户号 String 否 10 merchantOrderN o 商户订单号 全局唯一由数字或字母组成长度须控 制在 12 到 25 之间可包含边界值 String 是 11 receiverAccount NoEnc 收款账户号 收款人银行卡卡号 String 是 12 receiverNameEn c 收款人 收款人银行卡持卡人名称 String 是 13 receiverAccount Type 账户类型 账户类型 Integer 是 14 receiverBankCh annelNo 收款账户联行号 对公账户必须填写此字段 String 否 15 paidAmount 交易金额 交易金额 BigDecima l 是 16 currency 币种 人民币201 String 是 17 isChecked 是否复核 复核201不复核202 String 是 18 paidDesc 代付说明 填写此次单笔代付的代付说明长度为 30 个字符以内 String 是 19 paidUse 代付用途 代付用途 String 是 20 hmac 签名数据 String 是 请求报文案例
{
userNo: 888100000004182,
productCode: BANK_PAY_ORDINARY_ORDER,
hmac: A47EB696F9C41EAE72010456B556CFDB,
merchantBatchNo: 990000000001,
requestCount: 2,
requestAmount: 2.00,
requestTime: 2018-05-28 14:10:10,
callbackUrl:http://10.10.10.10:8080/pay/merchantCallback,
details: [{
userNo: 888100000004182,
merchantOrderNo: 880000000001,
receiverAccountNoEnc: 6225882010007926,
receiverNameEnc: 支付机构,
receiverAccountType: 201,
receiverBankChannelNo: 45545,
paidAmount: 1.00,
currency: 201,
isChecked: 202,
paidDesc: 工资发放,
paidUse: 201
},
{
userNo: 888100000004182,
merchantOrderNo: 880000000002,
receiverAccountNoEnc: 6225882010007926,
receiverNameEnc: 支付机构,
receiverAccountType: 201,
receiverBankChannelNo: 45545,
paidAmount: 1.00,
currency: 201,
isChecked: 202,
paidDesc: 工资发放,
paidUse: 201
}
]
}
3.3.2应答代付接口 参数名称 中文名称 说明 数据类 型 是否 必填 签名 顺序 statusCode 应答码 请求响应的应答码 String 是 1 message 应答信息 请求响应的应答码信息描述 String 是 2 data 应答数据 代付数据见应答信息域应答信息域对象转 成 json 字符串 json 字符 串 是 应答数据域 errorCode 错误码 受理失败、受理中会在应答中返回错误码 String 否 3 errorDesc 错误描述 受理失败、受理中会在应答中返回错误码 String 否 4 userNo 商户编号 商户在支付平台系统的唯一身份标识。 String 是 5 merchantBatchN o 商户批次号 全局唯一性由商户生成并在发起代付请求 的时候传入 String 是 6 acceptSuccessC ount 受理成功笔数 已受理商户批量请求笔数的累加 Integer 是 7 acceptFailCount 受理失败笔数 没有受理商户批量请求笔数的累加 Integer 是 8 requestCount 请求总笔数 商户请求的批量请求笔数总和 Integer 是 9 requestAmount 请求总金额 商户请求的批量请求金额总和 BigDeci mal 是 10 hmac 签名数据 参考 5.签名机制 String 是 应答报文案例
{
statusCode: 2001,
message: 受理成功
data: {
errorCode: ,
errorDesc: ,
userNo: 888100000004182,
merchantBatchNo: 990000000001,
acceptSuccessCount: 2,
acceptFailCount: 0,
requestCount: 2,
requestAmount: 2.00,
hmac: 81D3430BF3E4A1D05958FE99FB5434A4
},
} 3.3.3异步通知参数列表
交易成功或交易失败时异步通知以 POST 请求方式返回 Json 数据。如若通知响应 statusCode 为
2001则我司系统将进行二次补发通知补发频率为 5, 20, 60, 120, 180, 240s。
接入方对异步通知需要作幂等处理。 参数名称 中文名称 说明 数据类型 是否 必填 签名 顺序 status 状态 批量代付请求的交易状态 Integer 是 1 userNo 商户号 商户在支付平台系统的唯一身份标识。 String 是 2 merchantBatchNo 商户批次号 全局唯一性由商户生成并在发起代付请 求的时候传入 String 是 3 platformBatchNo 支付批次号 全局唯一性成功受理商户的代付请求时 生成的批次号 String 否 4 successCount 成功笔数 成功处理的笔数累加 Integer 是 5 successAmount 成功金额 成功处理的金额累加 BigDecimal 是 6 failCount 失败笔数 处理失败的笔数累加 Integer 是 7 failAmount 失败金额 处理失败的金额累加 BigDecimal 是 8 processCount 处理中笔数 在处理中的笔数累加 Integer 是 9 processAmount 处理中金额 在处理中的金额累加 BigDecimal 是 10 requestCount 请求总笔数 商户请求的批量请求笔数总和 Integer 是 11 requestAmount 请求总金额 商户请求的批量请求金额总和 BigDecimal 是 12 acceptCount 受理总笔数 受理商户批量请求笔数的累加 Integer 是 13 acceptAmount 受理总金额 受理商户批量请求金额的累加 BigDecimal 是 14 feeSum 总手续费 成功订单计算的手续费总和 BigDecimal 否 15 singleNotifyList 批量明细列 表 代付明细数据见子域子域 List 转成json 字符串 json 数据字 符串 是 16 批量明细列表域 status 状态 代付明细交易状态 Integer 是 17 errorCode 错误码 受理失败、受理中会在应答中返回错误码 String 否 18 errorCodeDesc 错误描述 受理失败、受理中会在应答中返回错误码 String 否 19 userNo 商户编号 商户在支付平台系统的唯一身份标识。 String 是 20 tradeMerchantNo 报备商户号 报备商户号 String 否 21 merchantOrderNo 商户订单号 全局唯一性由商户生成并在发起代付请求的时候传入 String 是 22 platformSerialNo 平台流水号 全局唯一性在成功受理商户的代付请求 时生成的流水号 String 否 23 receiverAccount NoEnc 收款账户号 收款账户号信息 String 是 24 receiverNameEnc 收款人 收款人信息 String 是 25 paidAmount 交易金额 此订单交易金额 BigDecimal 是 26 fee 手续费 此成功订单在该次代付交易中所需额外支 付的费用。 BigDecimal 否 27 completeTime 完成时间 代付完成时间格式yyyy-MM-dd HH:mm:ss 默认不返回如果有此参数需求请联系客服。 String 是 28 hmac 签名数据 String 是
请求报文案例
{
status: 203,
successAmount: 2.00,
successCount: 2,
userNo: 888100000004182
hmac: 81D3430BF3E4A1D05958FE99FB5434A4
acceptAmount: 2.00,
acceptCount: 2,
failAmount: 0.00,
failCount: 0,
feeSum: 0.22,
merchantBatchNo: 990000000001,
platformBatchNo: 20022018053100002949,
processAmount: 0.00,
processCount: 0,
requestAmount: 2.00,
requestCount: 2,
hmac: 81D3430BF3E4A1D05958FE99FB5434A4
singleNotifyList: [{ fee: 0.11,
merchantOrderNo: 880000000002,
paidAmount: 1.00,
platformSerialNo: 30032018053100031394,
receiverAccountNoEnc: 6225882010007926, receiverNameEnc: 支付机构,
status: 205,
userNo: 888100000004182}, {fee: 0.11,
merchantOrderNo: 880000000001,
paidAmount: 1.00,
platformSerialNo: 30032018053100031393,
receiverAccountNoEnc: 6225882010007926, receiverNameEnc: 支付机构,
status: 205,
userNo: 888100000004182}],
}
3.3.4商户返回确认信息 参数名称 中文名称 说明 数据类 型 是否 必填 签名 顺序 statusCode 应答码 商户受理回调通知后返回的应答码 String 是 1 message 应答信息 商户受理回调通知后处理失败返回的错 误描述 String 否 2
应答报文案例
{
statusCode: 2001, message : 成功
}3.4余额查询
3.4.1请求参数列表 参数名称 中文名称 说明 数据类型 是否必填 签名 顺序 userNo 商户编号 商户在支付平台系统的唯一身份标识。 String 是 1 hmac 签名数据 String 是
请求报文案例
{userNo: 888100000000002,hmac: 484F1C01DED2A9176B17C6AFC11DA219}
注以上案例仅限于格式的参考并不能作为真实数据发起请求。
3.4.2应答参数接口 参数名称 中文名称 说明 数据类型 是否 必填 签名 顺序 statusCode 应答码 请求响应的应答码 String 是 1 message 应答信息 请求响应的应答码信息 描述 String 是 2 data 应答数据 数据见应答信息域应答信息域对象转成 json 字符串 json 字符串 是 应答数据域data userNo 商户号 商户在支付平台系统的 唯一身份标识。 String 是 3 userName 商户名称 商户在支付平台系统注 册的名称 String 是 4 currency 币种 余额账户统一记录的币种 人民币201 Integer 是 5 useAbleSettAmount 可取金额 除去风控冻结金额剩余 的可结算金额 BigDecimal 是 6 availableSettAmount Frozen 可结算冻结金额 代付处理中的金额 BigDecimal 是 7 errorCode 错误码 受理失败、受理中会在应答中返回错误码 String 否 8 errorDesc 错误描述 受理失败、受理中会在应答中返回错误信息 String 否 9 hmac 签名数据 String 是 应答报文案例
{data: {userNo: 888100000004182,userName: 支付机构, currency: 201,useAbleSettAmount: 29233.05,availableSettAmountFrozen: 82982.81, errorCode: ,errorDesc: ,hmac: 484F1C01DED2A9176B17C6AFC11DA219},statusCode: 2001, message: 查询成功}
注响应数据的顺序不代表签名的顺序签名顺序请查阅文档的表格所对应的顺序
4.签名机制
为了保证数据传输过程中的数据真实性和完整性我们需要对请求和返回数据进行签名在接收签名数据之后进行签名校验。 签名按照参数的签名顺序将参数的值拼接后将密钥拼接在后面生成签名的原始串再按照相应的加密方法进行加密计算出签名的结果。
4.1待签名字符串
无论是请求还是应答都按照以下方式拼接待签名字符串 1、除hmac 字段外所有参数按照文档要求的顺序设值并参与拼接待签名字符串。 2、在待签名字符串中字段名和字段值都采用原始值不进行URL Encode。 3、空值及null 不参与验签。
4.2MD5签名
商户支付签名方式在商户入网时由商户后台自行选择MD5 还是RSA 方式。 采用MD5 算法进行签名。在MD5 签名时需要商户密钥参与签名商户密钥是以英文字母和数字组成的32 位字符串商户可以登录汇聚支付门户系统查看密钥信息。通过在待签名字符串后加商户密钥的内容进行MD5 运算形成的摘要字符串为签名结果。
