hshafiei374/bitrah

1.1.0 2020-11-22 07:18 UTC

This package is auto-updated.

Last update: 2024-10-29 06:18:36 UTC


README

Bitrah Gateway Laravel Package

Package for bitrah gateway

License: MIT

Bitrah is a Laravel package that helping Laravel developers implement Bitrah gateway .

Features

  • بسیار ساده و قدرتمند

Getting Started

پکیج را با دستور زیر نصب میکنیم

composer require hshafiei374/bitrah

اگر ورژن لاراول شما کمتر از 5.4 است باید وب هوک و کال بک را در آرایه ی $except در کلاس VerifyCsrfToken قرار دهید.

Code

بااستفاده از کد زیر یک درخواست به بیتراه میفرستیم

$result = Bitrah::submitRequest(orderId '1',rialValue '270000000', callbackurl 'http://your-domain.com/bitrah_call_back', webhookkurl 'http://your-domain.com/bitrah_webhook');
/*
$result is : 
[
'data'=>[
        'token'=>'0d0cd5a0445647asdasdcff2c48ad69e7',
        'redirectUrl'=>https://www.bitrah.ir/en/BitrahTestAccount?token=0d0cd5a044564783asc48ad69e7&mode=off&coin=BTC&amount=25000'',
        'multiCoinRedirectUrl'=>'https://www.bitrah.ir/en/BitrahTestAccount?token=0d0cd5asdcccff2c48ad69e7&mode=on&coin=BTC&amount=25000',
        'refId'=>'2547'
    ],
'message'=>'Successfully done!',
'timesatmp'=>'2020-11-14T06:56:43.646+0000',
'success'=>'true'
];
*/

شما باید اطلاعات گرفته شده از بیتراه را در دیتا بیس خود ذخیره کنید و چک کنید اگر قبلا refId و token در دیتا بیس شما وجود نداشته باشد.

سپس باید کاربر را به url دریافتی از بیتراه هدایت کنید.

کاربر وارد صفحه پرداخت بیتراه می شود

Code

بعد از پرداخت کاربر به لینک کالبک سایت شما باز می گردد. در این مرحله شما باید چک کنید که این درخواست قبلا پردازش نشده باشد.

در نهایت بعد از تایید پرداخت وب هوک شما توسط بیتراه صدا زده می شود.

شما همچنین می توانید با استفاده از متد زیر در هر زمانی وضعیت تراکنش خود را با استفاده از refId مشخص کنید

$result = Bitrah::getTransactionStatus($refId);
/*
$result is: 
array:4 [▼
  "data" => array:5 [▼
    "status" => 2
    "orderId" => "1"
    "refId" => "4805"
    "coin" => "TRX"
    "value" => "3.293901000"
  ]
  "message" => "Successfully done!"
  "timestamp" => "2020-11-22T07:16:15.936+0000"
  "success" => true
]
*/

Documentation

documentation.

Changelog

v1.0.0

  • پیاده سازی درخواست

License

The MIT License (MIT). Please see License File for more information.