README

台湾万事达Gomypay金流API的PHP客户端

这不是官方包！这个PHP库允许开发者轻松与Gomypay API交互，以访问数据和处理支付。

要求

要使用Gomypay API客户端，需要以下内容

• 为自己获取一个Gomypay 账户。
• 现在你可以使用Gomypay API客户端了。
• PHP >= 7.4
• 最新的OpenSSL（或其他SSL/TLS工具包）

Composer安装

到目前为止，最简单安装Gomypay API客户端的方法是使用Composer。

$ composer require ediasoft/gomypay-api-php:^1.0

{
    "require": {
        "ediasoft/gomypay-api-php": "^1.0"
    }
}

或者，你可以手动下载库并将其包含在你的项目中。

入门

初始化

首先，你必须初始化GomypayApiClient类，并将客户ID传递给它。密钥是可选的，仅在获取JSON响应而不是标准重定向响应时才需要。另一个可选参数是配置数组，你可以设置模式（测试/生产）和默认返回和回调URL。默认情况下，所有交易都设置为生产模式。

use eDiasoft\Gomypay\GomypayApiClient;

$gomypay = new GomypayApiClient('CUSTOMER_ID', 'SECRET_KEY_THIS_IS_OPTIONAL', array(
    'test'              => true, //This will change the transaction to test.
    'store_id'          => 'GOMYPAY_STORE_ID',  //Set the store id.
    'returnUrl'         => 'https://example.com/gomypay/return',
    'callbackUrl'       => 'https://example.com/gomypay/callback'
));

发送信用卡请求

此示例演示如何发送信用卡请求

use eDiasoft\Gomypay\Types\PaymentMethods;

$creditcard = $gomypay->payWith(PaymentMethods::CREDITCARD)->create([
    'Order_No'      => uniqid(), //Must be unique everytime
    'Amount'        => 1000, //Amount in TWD, must be more than 35 yuan
    'Buyer_Name'    => 'John Doe',
    'Buyer_Telm'    => '0912345678',
    'Buyer_Mail'    => 'john@example.com',
    'Buyer_Memo'    => 'Noodles',
    'CardNo'        => '4907060600015101', //Example creditcard number that results in success
    'ExpireDate'    => '2412', //YYMM
    'CVV'           => '615'
]);

请求创建后，你可以执行请求。有两种方法可以执行。要获取JSON响应，你必须填写密钥和商店ID。JSON请求自动与md5 str_check进行比较。

use eDiasoft\Gomypay\Types\Response;

$creditcard->execute(); //Normal execute with redirect to Gomypay page

$creditcard->execute(Response::json); //Request json response

支持的支付方式

• 信用卡 $gomypay->payWith(PaymentMethods::CREDITCARD)
• 银联卡 $gomypay->payWith(PaymentMethods::UNIONPAY)
• 超商条码 $gomypay->payWith(PaymentMethods::SPMBARCODE)
• WebAtm $gomypay->payWith(PaymentMethods::WEBATM)
• 虚拟账户 $gomypay->payWith(PaymentMethods::VIRTUALACCOUNT)
• 定期扣款 $gomypay->payWith(PaymentMethods::REGULARDEDUCTION)
• 超商代码 $gomypay->payWith(PaymentMethods::SPMCODE)
• LinePay $gomypay->payWith(PaymentMethods::LINEPAY)

许可证

Gomypay API PHP客户端是开源软件，许可协议为MIT许可证。

支持

联系：ediasoft.com — info@ediasoft.com — +31 10 84 342 77