Skip to content

Commit

Permalink
feat(readme): add the cmb use doc.
Browse files Browse the repository at this point in the history
  • Loading branch information
helei112g committed Feb 3, 2020
1 parent 8bd5bae commit ac8033b
Showing 1 changed file with 82 additions and 5 deletions.
87 changes: 82 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -608,9 +608,7 @@ $config = [

'op_pwd' => 'xxxxx', // 操作员登录密码。
'sign_type' => 'SHA-256', // 签名算法,固定为“SHA-256”
'limit_pay' => [
//'A',
], // 允许支付的卡类型,默认对支付卡种不做限制,储蓄卡和信用卡均可支付 A:储蓄卡支付,即禁止信用卡支付
'limit_pay' => 'A', // 允许支付的卡类型,默认对支付卡种不做限制,储蓄卡和信用卡均可支付 A:储蓄卡支付,即禁止信用卡支付

'notify_url' => 'https://dayutalk.cn/notify/cmb', // 支付成功的回调

Expand All @@ -621,6 +619,85 @@ $config = [
];
```

#### 支付请求参数

字段 | 解释 | 必须
---|---|---
date | 订单的日期,时间戳 | Y
trade_no | 订单号,6-32位的数字和字母组合,由商户生成 | Y
amount | 格式:xxxx.xx 固定两位小数,最大11位整数 | Y
time_expire | 过期时候的时间戳 | Y
return_param | 发送成功支付结果通知时,将原样返回商户 | N
body | 显示在PC端扫码支付页面,pc支付才需要该参数 | N
client_ip | 商户取得的客户IP,如果有多个IP用逗号”,”分隔。 | N
sub_mch_id | 当前订单为商户的二级商户的订单时需要传送 | N
sub_mch_name | 当前订单为商户的二级商户的订单时需要传送 | N
sub_mch_tp_code | 当前订单为商户的二级商户的订单时需要传送;必须为数字或字母 | N
sub_mch_tp_name | 当前订单为商户的二级商户的订单时需要传送 | N
mode_type | 默认不设限制,允许微信支付。 | N
agr_no | 客户协议号 | N
merchant_serial_no | 协议开通请求流水号,开通协议时必填。 | N
user_id | 用于标识商户用户的唯一ID | N
mobile | 手机号码 | N
lon | 经度 | N
lat | 纬度 | N
risk_level | 用户在商户系统内风险等级标识 | N

#### 查询公钥请求参数

> 不需要参数,直接条用即可

#### 退款请求参数

字段 | 解释 | 必须
---|---|---
date | 商户订单日期,支付时的订单日期 格式:yyyyMMdd | Y
trade_no | 商户订单号,支付时的订单号 | Y
refund_no | 退款流水号,商户生成,同一笔订单内,同一退款流水号只能退款一次。可用于防重复退款。 | Y
refund_fee | 退款金额,格式xxxx.xx,单位元 | Y
reason | 退款描述 | N
operator_id | 商户结账系统的操作员号,选填,若填了则会对操作员号和密码进行校验,若不填则不校验。 | N


#### 查询订单请求参数

字段 | 解释 | 必须
---|---|---
type | 查询类型,A:按银行订单流水号查询(默认) B:按商户订单日期和订单号查询 | N
transaction_id | 银行订单流水号,type=A时必填 | Y
date | 商户订单日期,格式:yyyyMMdd | Y
trade_no | type=B时必填商户订单号 | N
operator_id | 商户结账系统的操作员号 | N

#### 已结账单请求参数

字段 | 解释 | 必须
---|---|---
mode | 查询模式, bank:按照银行日期查询,默认; mch:按照商户日期查询 | Y
start_time | 开始日期,时间戳 | Y
end_time | 结束日期,时间戳 | Y
operator_id | 操作员号,商户结账系统的操作员号 | Y
next_key_value | 续传键值,长度只能为0或40;首次查询填“空”;后续查询,按应答报文中返回的nextKeyValue值原样传入。 | N

#### 退款查询请求参数

字段 | 解释 | 必须
---|---|---
type | 查询类型 A:按银行退款流水号查单笔(默认) B:按商户订单号+商户退款流水号查单笔 C: 按商户订单号查退款 | Y
trade_no | 商户订单号 | Y
date | 商户订单日期,时间戳 | Y
refund_no | 商户退款流水号长度不超过20位 | Y
bank_serial_no | 银行退款流水号长度不超过20位 | Y

#### 对账单查询请求参数

字段 | 解释 | 必须
---|---|---
date | 商户订单日期,时间戳 | Y
message_key | 交易流水,合作方内部唯一流水 | Y


## 设计支付系统

`Payment` 解决了对接第三方渠道的各种问题,但是一个合理的支付完整系统该如何设计?估计大家还有很多疑问。关于支付系统的设计大家可以参考该项目:https://github.com/skr-shop/manuals
Expand Down Expand Up @@ -693,11 +770,11 @@ $config = [

## 代码设计

整个代码结构的设计
整个代码结构的设计,待补充

## 开发指南

接入一个新的能力该如何操作
接入一个新的能力该如何操作,待补充

# 第三方文档

Expand Down

0 comments on commit ac8033b

Please sign in to comment.