README

支持 Laravel 的 composer 包

安装

composer require hamid-a/saderat-pg

使用

初始化

use SaderatPaymentGateway\SaderatPG;

$tid = 'terminal-id';
$mid = 'merchant-id';
$public_key = __DIR__.'/saderat-public-key.pub'; // path to public key file
$private_key = __DIR__.'/saderat-private-key.key'; // path to private key file
$callback_url = 'callback-url'; // we can set calback url in initializing or getToken section


$gateway = new SaderatPG($tid, $mid, $public_key, $private_key, $callback_url);

请记住密钥必须采用标准格式

-----BEGIN PRIVATE KEY-----
PRIVATE KEY CONTENT
-----END PRIVATE KEY-----

-----BEGIN PUBLIC KEY-----
PUUBLIC KEY CONTENT
-----END PUBLIC KEY-----

获取令牌

$amount = 1000; // in int format
$crn = 'customer receipt number'; // must be unique in each transaction
$callback_url = 'callback-url'; // we can set calback url in initializing or getToken section
token = '';
try {

    $token = $gateway->getToken($amount, $crn, $callback_url);

} catch (\Exception $e){
    echo 'Error code:'.$e->getCode().' Error message:'.$e->getMessage();
}
if($token != '') {
// redirect user to: https://mabna.shaparak.ir/?ID=$token
} 

验证交易

$verified = fasle;

try {

    $verified = $gateway->verifyTransaction($token, $_POST['CRN'], $_POST['TRN'], $_POST['SIGNATURE']);

} catch(\Exception $e){
    echo 'Error code:'.$e->getCode().' Error message:'.$e->getMessage();
}

if($verified) {
//transaction verified
} else {
// verification failed
}

Laravel 集成

在 laravel >= 5.5 中，服务提供者和外观将自动注册。但在旧版本中，您需要在 config/app.php 文件中添加外观和服务提供者。

...
'providers' => [
    ...
    SaderatPaymentGateway\Laravel\SaderatPGServiceProvider::class,
],
'aliases' => [
    ...
    'SaderatPG' => SaderatPaymentGateway\Laravel\Facade\SaderatPG::class,
]

将配置添加到 config/services.php

    'saderat-pg' => [
        'mid' => 'your merchant id',
        'tid' => 'your terminal id',
        'public-key' => __DIR__.'/saderat-public-key.pub', // path to public key file
        'private-key' => __DIR__.'/saderat-private-key.key', // path to private key file
        'callback-url' => '' // callback url (not required but it should provided in getToken request)
    ]

使用外观进行请求

use SaderatPG;

// get token
$token = SaderatPG::getToken($amount, $crn, $callback_url);

// verify transaction
$verified = SaderatPG::verifyTransaction($token, $request->get('CRN'), $request->get('TRN'), $request->get('SIGNATURE'));