Atome支付API的简单SDK包。可作为独立包使用,或与Laravel一起使用。

0.0.2 2024-01-05 21:52 UTC

This package is auto-updated.

Last update: 2024-09-05 23:38:01 UTC


README

Latest Version on Packagist Total Downloads GitHub Actions

Atome支付网关的SDK。可作为独立包使用,或与laraditz/bayar Laravel包一起使用。

安装

composer require gerbang-bayar/atome

可用请求方法

以下是此包下所有可用方法。

  • checkConfiguration(string $countryCode, ?string $callbackUrl = null): Response
  • createPayment(array $args): Response
  • getPayment(string $referenceId): Response
  • cancelPayment(string $referenceId): Response
  • refundPayment(string $referenceId): Response

用法

创建支付

创建支付并获取重定向到的支付URL。

use GerbangBayar\Atome\Atome;


// Instantiate connector
$atome = new Atome(username: $username, password: $password, sandbox: false);

$response = $atome->createPayment(
    referenceId: 'someuniquereferenceid',
    currency: 'MYR',
    amount: 1000, // in cents
    callbackUrl: 'https://callbackurl.here',
    paymentResultUrl: 'https:/returnurl.here',
    customerInfo: [
        'name' => 'Raditz Farhan',
        'phone' => '6012345678',
        'email' => 'raditzfarhan@gmail.com'
    ],
    shippingAddress: [
        'countryCode' => 'MY',
        'lines' => [
            'No 1, Taman ABC',
            'Jalan DCEF'
        ],
        'postCode' => '12345'
    ],
    items: [
        [
            'itemId' => 'ITEMSKU',
            'name' => 'Item 1',
            'quantity' => 1,
            'price' => 1000,
        ]
    ]
);

请参阅文档获取更多详细信息。

与Laravel一起使用

您可以使用此包与laraditz/bayar作为提供者一起使用。

向config/services.php添加配置

'atome' => [
    'username' => env('ATOME_USERNAME'),
    'password' => env('ATOME_PASSWORD'),
    'sandbox' => env('ATOME_SANDBOX', false),
],

添加提供者事件监听器

protected $listen = [
    \Laraditz\Bayar\Events\AtomeCallbackReceived::class => [
        // register your listener here
    ],
];

测试

composer test

变更日志

请参阅变更日志获取更多关于最近更改的信息。

贡献

请参阅贡献指南获取详细信息。

安全性

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

鸣谢

许可

MIT许可(MIT)。请参阅许可文件获取更多信息。