接口接入文档案例1

【接口接入文档案例1】是关于小熊宝支付接口的说明文档，主要涉及微信、QQ和支付宝三种支付渠道的接入，以及如何通过API发起付款、处理回调通知等关键环节。 1. **支付渠道接入**： - 微信支付：支持扫码支付，`paytype = WX`，注意参数值需大写。 - QQ支付：同样支持扫码支付，`paytype = QQ`，参数值也需大写。 - 支付宝支付：支持H5和扫码支付，`paytype = ALIPAY`，同样要求大写。 2. **发起付款接口**： - 接口有2种方式发起支付：直接跳转到支付页或获取JSON数据自定义支付页。 - **跳转支付页接口**：URL为`https://api.shaimeixiong.com/api/receive?type=form`，推荐使用POST方式，通过表单提交参数并跳转。 - **获取支付JSON数据接口**：URL为`https://api.shaimeixiong.com/api/receive?type=json`，POST方式请求，接收返回的JSON数据，然后自行构建支付页面。 3. **接口请求参数**： - `type`：调用方式，可以是`form`（表单模式）或`json`（返回JSON结构数据）。 - `merchantId`：商户唯一标识，注册后在后台获取。 - `money`：订单金额，必须是十进制数字。 - `timestamp`：精确到毫秒的时间戳。 - `goodsName`：商品名称，可选填。 - `notifyURL`：回调地址，支付成功后系统会向此地址发送通知。 - `returnURL`：支付结果展示地址，用户支付成功后跳转至此页面，仅在表单模式下建议填写。 - `merchantOrderId`：商户自定义订单号，必须项。 - `merchantUid`：商户提交支付的用户ID，可选填。 - `sign`：签名，基于参数和秘钥进行MD5-32位加密得到的小写字符串。 - `paytype`：支付类型，可选填`WX`、`QQ`或`ALIPAY`，均需大写。 4. **签名生成示例**： - 使用PHP为例，将参数和秘钥按照特定顺序连接，然后进行MD5-32位加密，如 `$sign = md5($money.'&'.$merchantId.'&'.$notifyURL.'&'.$returnURL.'&'.$merchantOrderId.'&'.$timestamp.'&'.$secretKey);` 5. **JSON请求返回值**： - 包含了支付平台订单号、商家订单号、收款码内容（Base64编码）、支付来源、收款金额、条码金额、客户端识别和商户号等信息。 6. **回调通知处理**： - 用户支付成功后，系统会向`notifyUrl`发送POST通知，服务器应返回200状态码以确认接收成功。若返回非200状态，系统会在1分钟内重试3次。 小熊宝支付接口的接入涉及到多种支付渠道的选择、参数的设置、签名的生成，以及支付回调的处理。开发人员在实现接口集成时，需确保所有参数正确无误，并能够妥善处理支付成功后的回调通知，以确保支付流程的顺利进行。同时，要注意安全问题，如签名的计算，以防止数据被篡改。