README

用于Gkash支付网关的简单Laravel包。

安装

您可以通过composer安装此包

composer require laraditz/gkash

开始前

在您的 .env 文件中配置您的变量（推荐），或者您可以发布配置文件并在那里进行更改。

GKASH_MERCHANT_ID=<your_merchant_id_here>
GKASH_SIGNATURE_KEY=<your_signature_key_here>
GKASH_SANDBOX_MODE=true # true or false for sandbox mode

（可选）您可以通过以下命令发布配置文件

php artisan vendor:publish --provider="Laraditz\Gkash\GkashServiceProvider" --tag="config"

运行迁移命令以创建必要的数据库表。

php artisan migrate

用法

创建支付

要创建支付并获取重定向的支付URL，您可以使用服务容器或外观。

// Create a payment

// Using service container
$payment = app('gkash')->refNo('ABC1234')->amount(100)->returnUrl('https://returnurl.com')->createPayment();

// Using facade
$payment =  \Gkash::refNo('ABC1234')->amount(100)->returnUrl('https://returnurl.com')->createPayment();

返回示例

[
    "code" => "5Xpj9IPN",
    "currency_code" => "MYR",
    "amount" => 100,
    "payment_url" => "http://myapp.com/gkash/pay/5Xpj9IPN"
]

重定向到 payment_url 以继续Gkash支付页面。完成后，您将被重定向到returnUrl。以下是一个示例响应。

[
  "amount" => "1.00",
  "code" => "5Xpj9IPN",
  "currency" => "MYR",
  "id" => "98043afa-d795-43b1-a6da-af735ba43db0",
  "merchant_id" => "MXXX-X-XXXXX",
  "payment_type" => "TnG ECOMM",
  "ref_no" => "ABC14393647840",
  "signature" => "0bfe2724c9c29dcd5c086a1f45f28ce0b702dd86dddef8eb40d46001ce76dff76a8f18b9f993f6cbb104206041866f239c4239878f62c043b4252a0c00a3a374",
  "status" => 3,
  "status_text" => "Success",
  "vendor_ref_no" => "MXXX-PO-XXXXXX",
]

事件

此包还提供了一些事件，允许您的应用程序监听它。您可以在以下事件下创建监听器并注册它。

测试

composer test

更新日志

请参阅更新日志以获取有关最近更改的更多信息。

贡献

有关详细信息，请参阅贡献。

安全

如果您发现任何与安全相关的问题，请通过电子邮件raditzfarhan@gmail.com报告，而不是使用问题跟踪器。

鸣谢

• Raditz Farhan
• 所有贡献者

许可

MIT许可（MIT）。有关更多信息，请参阅许可文件。