README

CakePHP 对 Mpay24 官方 PHP SDK 客户端的封装MPAY24 官方 PHP SDK

• Mpay24 GitHub: https://github.com/mpay24/mpay24-php
• Mpay24 文档: https://docs.mpay24.com/docs
• Mpay24 示例: https://docs.mpay24.com/docs/get-started

安装

您可以使用 composer 将此插件安装到您的 CakePHP 应用程序中。

安装 composer 包的推荐方法是

composer require fm-labs/cakephp-mpay24

// src/Application.php

class Application extends \Cake\Application {
    public bootstrap($configDir) {
        // ... your bootstrap code ...
        $this->addPlugin('FmLabs/Mpay24')
    }
}

配置

// config/mpay24.php

<?php
return [
    'Mpay24' => [
        'production' => [
            'merchantId' => '',
            'merchantPassword' => '',
            'useTestSystem' => false,
            'debug' => true,
        ],

        'testing' => [
            'merchantId' => '',
            'merchantPassword' => '',
            'useTestSystem' => true,
            'debug' => true,
        ]
    ]
];

用法

API 客户端

try {
    $mpay24 = new \FmLabs\Mpay24\Lib\Mpay24Client('testing');
    
    $mdxi = new \FmLabs\Mpay24\Lib\Mpay24Order()
    // ... setup mdxi order ...

    if (!$mdxi->validate()) {
        throw new \RuntimeException('Failed to validate MDXI.');
    }

    $mpay24Response = $mpay24->paymentPage($mdxi);
    $paymentPageURL = $mpay24Response->getLocation(); // get redirect location to the payment page
    if ($paymentPageURL) {
        // ... redirect user to payment page ... 
    }
} catch (\Exception $ex) {
    debug("Something went wrong: " . $ex->getMessage());
}

测试数据

所有测试数据在官方文档中： https://docs.mpay24.com/docs/test-data

信用卡

测试数据

Mastercard card number: 5555444433331111
Visa card number: 4444333322221111
Expiry date: arbitrary, see Test scenarios below

测试场景：通过为品牌 VISA 和 MASTERCARD 的信用卡提供不同的到期日期，可以创建各种场景的结果