Skip to content

Commit

Permalink
cleanup + readme
Browse files Browse the repository at this point in the history
  • Loading branch information
FaridAghili committed Jun 6, 2021
1 parent 3428039 commit ab84044
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 14 deletions.
41 changes: 32 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# زرین پال | Zarinpal

Zarinpal library for Laravel
Zarinpal library for Laravel based on Zarinpal API v4

کتابخانه زرین پال برای لاراول
کتابخانه زرین پال برای لاراول براساس نسخه 4 ای‌پی‌آی زرین پال

## روش نصب - Installation

Expand All @@ -13,6 +13,7 @@ Use composer to install this package
```bash
composer require pishran/zarinpal
```

## تنظیمات - Configuration

Add your merchant id to .env file
Expand All @@ -23,6 +24,22 @@ Add your merchant id to .env file
ZARINPAL_MERCHANT_ID=00000000-0000-0000-0000-000000000000
```

To change currency to Toman (Default)

برای تغییر واحد پول به تومان (مقدار پیشفرض)

```dotenv
ZARINPAL_CURRENCY=IRT
```

To change currency to Rial

برای تغییر واحد پول به ریال

```dotenv
ZARINPAL_CURRENCY=IRR
```

To enable sandbox mode

برای فعالسازی حالت تست
Expand All @@ -33,17 +50,16 @@ ZARINPAL_SANDBOX_ENABLED=true

## روش استفاده | How to use

### ارسال مشتری به درگاه پرداخت
### ارسال مشتری به درگاه پرداخت | Send customer to payment gateway

```php
$response = zarinpal()
->amount(100) // مبلغ تراکنش به تومان
->amount(100) // مبلغ تراکنش
->request()
->zarin() // فعالسازی زرین گیت - اختیاری
->callback('https://domain.com/verification') // آدرس برگشت پس از پرداخت
->description('transaction info') // توضیحات تراکنش
->email('name@domain.com') // ایمیل مشتری - اختیاری
->callbackUrl('https://domain.com/verification') // آدرس برگشت پس از پرداخت
->mobile('09123456789') // شماره موبایل مشتری - اختیاری
->email('name@domain.com') // ایمیل مشتری - اختیاری
->send();

if (!$response->success()) {
Expand All @@ -57,10 +73,11 @@ if (!$response->success()) {
return $response->redirect();
```

### بررسی وضعیت تراکنش
### بررسی وضعیت تراکنش | Verify payment status

```php
$authority = request()->query('Authority'); // دریافت کوئری استرینگ ارسال شده توسط زرین پال
$status = request()->query('Status'); // دریافت کوئری استرینگ ارسال شده توسط زرین پال

$response = zarinpal()
->amount(100)
Expand All @@ -72,7 +89,13 @@ if (!$response->success()) {
return $response->error()->message();
}

// دریافت هش شماره کاتری که مشتری برای پرداخت استفاده کرده است
// $response->cardHash();

// دریافت شماره کارتی که مشتری برای پرداخت استفاده کرده است (بصورت ماسک شده)
// $response->cardPan();

// پرداخت موفقیت آمیز بود
// دریافت شماره پیگیری تراکنش و انجام امور مربوط به دیتابیس
return $response->referenceId();
```
```
5 changes: 0 additions & 5 deletions src/VerificationResponse.php
Original file line number Diff line number Diff line change
Expand Up @@ -40,11 +40,6 @@ public function success(): bool
return $this->code === 100;
}

public function alreadyVerified(): bool
{
return $this->code === 101;
}

public function cardHash(): string
{
return $this->cardHash;
Expand Down

0 comments on commit ab84044

Please sign in to comment.