README

一个简单的库，提供对土库曼斯坦本地银行支付处理服务的集成。

简介

Gateway-TM提供了与三个主要支付服务：Rysgal、AltynAsyr和Senagat的无缝集成。这个库简化了支付订单注册和状态检查的过程。它设计成易于扩展，允许用户通过扩展AbstractGateway类并实现自定义类来整合额外的网关服务。这确保了在集成新的支付服务类型时具有高度的灵活性。

需求

• Laravel 9或更高版本
• PHP 8.1或更高版本

安装与说明

默认安装方式是通过Composer。

composer require merdan/gateway-tm

包将自动注册。请手动将服务提供者和别名添加到您的config/app文件中的providers部分。

'providers' => [
    //...
    Merdanio\GatewayTM\Payment\Providers\GatewayServiceProvider::class,
]

    'aliases' => Facade::defaultAliases()->merge([
        // 'Example' => App\Facades\Example::class,
        'Gateway' => Merdanio\GatewayTM\Payment\Facades\GatewayFacade::class
    ])->toArray(),

发布配置

php artisan vendor:publish --tag="gateway"

请配置以下凭据到您的.env文件中，这些凭据您可以从银行获得。

ALTYN_ASYR_USER= ALTYN_ASYR_PASSWORD= ALTYN_ASYR_API= ALTYN_ASYR_ORDER_URI='register.do' ALTYN_ASYR_STATUS_URI='orderStatus.do'

RYSGAL_USER= RYSGAL_PASSWORD= RYSGAL_API= RYSGAL_ORDER_URI='register.do' RYSGAL_STATUS_URI=

SENAGAT_USER= SENAGAT_PASSWORD= SENAGAT_API= SENAGAT_ORDER_URI='register.do' SENAGAT_STATUS_URI='orderStatus.do'

用法

将网关外观添加到您的类或控制器中

use Gateway;

class MyController extends Controller {

    public function index() {
        return Gateway::availableGates();
    }
}

可用的支付提供者

Gateway::availableGates();

注册订单

Gateway::registerOrder('rysgal', // providers code
    'success_route_name',        // route to return when payment is successful
    'fail_route_name',           // route to return when payment failed
    14500,                       // payment amount 145 man.
    'Example Ecommerse payment', // payment description
    'ord-123'                    // payment order number
);

检查支付状态

Gateway::getOrderStatus(
    'rysgal', //providers code
    'ord-123' //order number
);

许可证

这是一个开源软件，遵循MIT许可证。