微信快速入门

在初始化完毕后，就可以直接方便的享受 yansongda/pay 带来的便利了。

TIP

yansongda/pay v3.x 版本直接支持 微信支付v3 版本，关于微信支付 v2/v3 版本区别，请参考官方文档

公众号支付

Pay::config($config);

$order = [
    'out_trade_no' => time().'', //需为 string 类型
    'description' => 'subject-测试',
    'amount' => [
        'total' => 1,
    ],
    'payer' => [
        'openid' => 'onkVf1FjWS5SBxxxxxxxx',
    ],
];

$result = Pay::wechat()->mp($order);
// 返回 Collection 实例。包含了调用 JSAPI 的所有参数，如appId，timeStamp，nonceStr，package，signType，paySign 等；
// 可直接通过 $result->appId, $result->timeStamp 获取相关值。
// 后续调用不在本文档讨论范围内，请自行参考官方文档。

H5支付

Pay::config($config);

$order = [
    'out_trade_no' => time().'',
    'description' => 'subject-测试',
    'amount' => [
        'total' => 1,
    ],
    'scene_info' => [
        'payer_client_ip' => '1.2.4.8',
        'h5_info' => [
            'type' => 'Wap',
        ]
    ],
];

return Pay::wechat()->h5($order);

APP 支付

Pay::config($config);

$order = [
    'out_trade_no' => time().'',
    'description' => 'subject-测试',
    'amount' => [
        'total' => 1,
    ],
];

// 将返回 json 格式，供后续 APP 调用，调用方式不在本文档讨论范围内，请参考官方文档。
return Pay::wechat()->app($order);

小程序支付

Pay::config($config);

$order = [
    'out_trade_no' => time().'',
    'description' => 'subject-测试',
    'amount' => [
        'total' => 1,
        'currency' => 'CNY',
    ],
    'payer' => [
        'openid' => '123fsdf234',
    ]
];

$result = Pay::wechat()->mini($order);
// 返回 Collection 实例。包含了调用 JSAPI 的所有参数，如appId，timeStamp，nonceStr，package，signType，paySign 等；
// 可直接通过 $result->appId, $result->timeStamp 获取相关值。
// 后续调用不在本文档讨论范围内，请自行参考官方文档。

刷卡支付（付款码，被扫码）

Pay::config($config);

$order = [
    'description' => '测试 - yansongda - 1',
    'out_trade_no' => time().'',
    'payer' => [
        'auth_code' => 'xxxxxxxxxxx'
    ],
    'amount' => [
        'total' => 1,
    ],
    'scene_info' => [
        'store_info' => [
            'id' => '5678'
        ],
    ],
];

$result = Pay::wechat()->pos($order);

扫码支付

Pay::config($config);

$order = [
    'out_trade_no' => time().'',
    'description' => 'subject-测试',
    'amount' => [
        'total' => 1,
    ],
];

$result = Pay::wechat()->scan($order);
// 二维码内容： $qr = $result->code_url;

转账

即，商家转账到零钱

Pay::config($config);

$order = [
    '_action' => 'mch_transfer', // 微信官方老版本下线后，此部分可省略
    'out_bill_no' => time().'',
    'transfer_scene_id' => '1001',
    'openid' => 'MYE42l80oelYMDE34nYD456Xoy',
    // 'user_name' => '闫嵩达'  // 明文传参即可，sdk 会自动加密
    'transfer_amount' => 1,
    'transfer_remark' => 'test',
    'transfer_scene_report_infos' => [
      ['info_type' => '活动名称', 'info_content' => '新会员有礼'],
      ['info_type' => '奖励说明', 'info_content' => '注册会员抽奖一等奖'],
    ],
];

// 以下为老版本调用方式，微信官方将于 2025年 3 月 31日 下线，建议使用新版本调用方式
$order = [
    'out_batch_no' => time().'',
    'batch_name' => 'subject-测试',
    'batch_remark' => 'test',
    'total_amount' => 1,
    'total_num' => 1,
    'transfer_detail_list' => [
        [
            'out_detail_no' => time().'-1',
            'transfer_amount' => 1,
            'transfer_remark' => 'test',
            'openid' => 'MYE42l80oelYMDE34nYD456Xoy',
            // 'user_name' => '闫嵩达'  // 明文传参即可，sdk 会自动加密
        ],
    ],
];

$result = Pay::wechat()->transfer($order);

退款

Pay::config($config);

$order = [
    // app，h5，jsapi，native，mini，退款在微信支付中，都是统一的接口，可以不用指定
    // 但是，如果你想指定，可以使用 _action 参数
    // 注意，合单退款，需要指定 _action 为 combine
    // '_action' => 'app', // 指定 app 退款
    // '_action' => 'combine', // 指定 合单 退款
    // '_action' => 'h5', // 指定 h5 退款
    // '_action' => 'jsapi', // 指定 jsapi 退款，默认
    // '_action' => 'mini', // 指定 小程序 退款
    // '_action' => 'native', // 指定 native 退款
    'out_refund_no' => time().'',
    'reason' => 'test',
    'amount' => [
        'refund' => 1,
        'total' => 1,
        'currency' => 'CNY',
    ],
];

$result = Pay::wechat()->refund($order);

查询订单

Pay::config($config);

$order = [
    'out_trade_no' => '123456789',
];

$result = Pay::wechat()->query($order);

// 查询退款订单
$order = [
    '_action' => 'refund',
    'out_refund_no' => '123456789',
];
$result = Pay::wechat()->query($order);

// 查询合单订单
$order = [
    '_action' => 'combine',
    'combine_out_trade_no' => '123456789',
];
$result = Pay::wechat()->query($order);

// 查询转账订单
$order = [
    '_action' => 'transfer',
    'out_batch_no' => '123456789',
    'out_detail_no' => '123456789',
];
$result = Pay::wechat()->query($order);

微信回调处理

Pay::config($this->config);

$result = Pay::wechat()->callback();

响应微信回调

Pay::config($this->config);

return Pay::wechat()->success();