umworks/wechatpay-v3-api

umworks 微信商户 v3 接口 API 库。

Maintainers

Details

gitee.com/umworks/wechatpay-v3-api.git

Installs: 38

Dependents: 0

Suggesters: 0

Security: 0

0.0.8 2020-07-17 09:41 UTC

Requires

Apache-2.0 6e02dc3bc081b7670820ac9817952bd789fe2bbf

This package is not auto-updated.

Last update: 2024-06-01 04:01:40 UTC

README

介绍

微信商户的 v3 接口封装。

单元测试请参考 测试说明 。

请严格遵守以下的准则来进行开发和测试

  • 禁止 在 src的源代码 和 单元测试 的代码里，直接 hard code 任何商户ID、SerialNo、PrivateKey（文本形态，我知道很多程序员这么干） 等关键数据。
  • 禁止 在 src的源代码 和 单元测试 的代码里，直接写任意的卡券ID，ticket 等明文数据
  • 所需的测试数据，必须 放在 protected 或 private 目录中（已经放入 .gitignore ），以文件的方式存放，并请遵守以下的守则：
    • 每在 protected 中添加一个所需的数据文件，必须在 example.protected 添加对应的文件
    • 每次修改、删除 protected 文件中的数据内容和字段，也必须在 example.protected 进行对应的操作
    • 每次提交前，请清除 example.protected 里的所有数据内容
  • 不强制要求代码注释和文档，但每一个封装过的接口，必须 附上接口对应的微信商户的文档的地址，格式为：// @see url...

已实现特性和接口

公共特性

  • V3 接口请求校验模式
  • V3 接口响应内容区分成功与失败，并提取数据

接口部分

  • 代金券 （VoucherApi）
    • 查询商户现有全部代金券（getVouchers）
    • 根据 stockId 查询商户特定代金券（getVoucher）
    • 发放的支付代金券 （giveVoucher）
      • 注意：该接口只是“发放”接口，并非把券放入到用户的卡包中。
      • 放入卡包的API接口，在H5页面中实现。（具体调用还需要确认）
    • 查询用户在某商户号可用的全部券（getUserVouchers）
    • 根据 couponId 查询用户特定代金券详情（getUserVoucher）
    • 根据 stockId 查询代金券可用的商户商户列表（getVoucherMerchants）

V2 接口

  • 签名算法，调用如下：

    $api = PayV3Api::getInstance($name);
$api->init( $merchantId,  $serialNo,  $privateKeyFile);
  
$data = []; //需要签名的数据
$appId = ''; //微信公众号的AppId
$res = $api->getMpSendCouponSign($appId, $data);

todo list