README

基于 Zarinpal API v4 的 Laravel Zarinpal 库

基于 Zarinpal API v4 的 Laravel Zarinpal 库

安装方法 - Installation

使用 composer 安装此包

您可以使用 composer 安装并使用此包

composer require pishran/zarinpal

配置 - Configuration

将您的商户 ID 添加到 .env 文件中

添加您的商户代码

ZARINPAL_MERCHANT_ID=00000000-0000-0000-0000-000000000000

您还可以在运行时定义商户 ID。

下面将详细介绍如何在运行时定义商户 ID。

将货币单位改为里亚尔（默认）

将货币单位改为里亚尔

ZARINPAL_CURRENCY=IRT

将货币单位改为里亚尔

将货币单位改为里亚尔

ZARINPAL_CURRENCY=IRR

使用方法 | How to use

将客户发送到支付网关 | Send customer to payment gateway

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

if (!$response->success()) {
    return $response->error()->message();
}

// ذخیره اطلاعات در دیتابیس
// $response->authority();

// هدایت مشتری به درگاه پرداخت
return $response->redirect();

验证支付状态 | Verify payment status

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

$response = zarinpal()
    ->merchantId('00000000-0000-0000-0000-000000000000') // تعیین مرچنت کد در حین اجرا - اختیاری
    ->amount(100)
    ->verification()
    ->authority($authority)
    ->send();

if (!$response->success()) {
    return $response->error()->message();
}

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

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

// پرداخت موفقیت آمیز بود
// دریافت شماره پیگیری تراکنش و انجام امور مربوط به دیتابیس
return $response->referenceId();