HEX
Server: LiteSpeed
System: Linux sv4.hami.host 5.14.0-611.54.3.el9_7.x86_64 #1 SMP PREEMPT_DYNAMIC Thu May 7 16:31:24 EDT 2026 x86_64
User: armgroup (1008)
PHP: 8.2.32
Disabled: show_source, system, shell_exec, passthru, exec, popen, proc_open, mail, socket_create, socket_create_listen, socket_create_pair, link, dl, openlog, syslog, stream_socket_server, curl_multi_init
Upload Files
File: //home/armgroup/libs/vendor/shetabit/multipay/src/Drivers/Parspal/Parspal.php
<?php

namespace Shetabit\Multipay\Drivers\Parspal;

use GuzzleHttp\Client;
use Shetabit\Multipay\Abstracts\Driver;
use Shetabit\Multipay\Contracts\ReceiptInterface;
use Shetabit\Multipay\Exceptions\InvalidPaymentException;
use Shetabit\Multipay\Exceptions\PurchaseFailedException;
use Shetabit\Multipay\Invoice;
use Shetabit\Multipay\Receipt;
use Shetabit\Multipay\RedirectionForm;
use Shetabit\Multipay\Request;
use chillerlan\SimpleCache\CacheOptions;
use chillerlan\SimpleCache\FileCache;

class Parspal extends Driver
{
    /**
     * HTTP Client.
     *
     * @var object
     */
    protected $client;

    /**
     * Invoice
     *
     * @var Invoice
     */
    protected $invoice;

    /**
     * Driver settings
     *
     * @var object
     */
    protected $settings;

    /**
     * Cache
     *
     * @var FileCache
     */
    protected $cache;

    protected const PAYMENT_PURCHASE_STATUS_OK = 'ACCEPTED';

    protected const PAYMENT_VERIFY_STATUS_OK = 'SUCCESSFUL';

    /**
     * Constructor.
     * Construct the class with the relevant settings.
     *
     * @param Invoice $invoice
     * @param $settings
     */
    public function __construct(Invoice $invoice, $settings)
    {
        $this->invoice($invoice);
        $this->settings = (object) $settings;
        $this->client = new Client();
        $this->cache = new FileCache(
            new CacheOptions([
                'filestorage' => $this->settings->cachePath,
            ])
        );
    }

    /**
     * Retrieve data from details using its name.
     *
     * @return string
     */
    private function extractDetails($name)
    {
        return empty($this->invoice->getDetails()[$name]) ? null : $this->invoice->getDetails()[$name];
    }

    /**
     * Purchase Invoice.
     *
     * @return string
     *
     * @throws PurchaseFailedException
     */
    public function purchase()
    {
        $data = [
            'amount' => $this->getInvoiceAmount(),
            'return_url' => $this->settings->callbackUrl,
            'order_id' => $this->invoice->getUuid(),
            'description' => $this->extractDetails('description'),
            'payer' => [
                'name' => $this->extractDetails('name'),
                'mobile' => $this->extractDetails('mobile'),
                'email' => $this->extractDetails('email'),
            ],
        ];

        $response = $this->client->request(
            'POST',
            $this->getPurchaseUrl(),
            [
                'headers' => [
                    'ApiKey' => $this->settings->merchantId,
                    'Content-Type' => 'application/json',
                ],
                'json' => $data,
                'http_errors' => false,
            ]
        );

        $body = json_decode($response->getBody()->getContents(), true);

        if ($body['status'] !== self::PAYMENT_PURCHASE_STATUS_OK) {
            throw new PurchaseFailedException($body['message'], $body['error_code'] ?? 0);
        }

        $this->invoice->transactionId($body['payment_id']);

        $this->cache->set('payment_link_' . $body['payment_id'], $body['link'], $this->settings->cacheExpireTTL);

        // return the transaction's id
        return $this->invoice->getTransactionId();
    }

    /**
     * Pay the Invoice
     *
     * @return RedirectionForm
     */
    public function pay(): RedirectionForm
    {
        $payUrl = $this->cache->get('payment_link_' . $this->invoice->getTransactionId());

        return $this->redirectWithForm($payUrl, [], 'GET');
    }

    /**
     * Verify payment
     *
     * @return ReceiptInterface
     *
     * @throws InvalidPaymentException
     */
    public function verify(): ReceiptInterface
    {
        $paymentStatusCode = Request::input('status');
        $paymentReceiptNumber = Request::input('receipt_number');

        if ($paymentStatusCode != 100) {
            throw new InvalidPaymentException($this->translateStatus($paymentStatusCode), $paymentStatusCode);
        }

        $data = [
            'amount' => $this->getInvoiceAmount(),
            'receipt_number' => $paymentReceiptNumber,
        ];

        $response = $this->client->request(
            'POST',
            $this->getVerificationUrl(),
            [
                'headers' => [
                    'ApiKey' => $this->settings->merchantId,
                    'Content-Type' => 'application/json',
                ],
                'json' => $data,
                "http_errors" => false,
            ]
        );

        $body = json_decode($response->getBody()->getContents(), true);

        if ($body['status'] !== self::PAYMENT_VERIFY_STATUS_OK) {
            throw new InvalidPaymentException($body['message'], $body['error_code'] ?? 0);
        }

        $receipt =  $this->createReceipt($paymentReceiptNumber);

        $receipt->detail([
            'id' => $body['id'],
            'paid_amount' => $body['paid_amount'],
            'message' => $body['message'],
        ]);

        return $receipt;
    }

    /**
     * Generate the payment's receipt
     *
     * @param $referenceId
     *
     * @return Receipt
     */
    public function createReceipt($referenceId)
    {
        return new Receipt('parspal', $referenceId);
    }

    /**
     * Retrieve invoice amount
     *
     * @return int|float
     */
    protected function getInvoiceAmount()
    {
        return $this->invoice->getAmount() * (strtolower($this->settings->currency) === 't' ? 10 : 1); // convert to rial
    }

    /**
     * Retrieve purchase url
     *
     * @return string
     */
    protected function getPurchaseUrl(): string
    {
        return $this->isSandboxMode()
            ? $this->settings->sandboxApiPurchaseUrl
            : $this->settings->apiPurchaseUrl;
    }

    /**
     * Retrieve verification url
     *
     * @return string
     */
    protected function getVerificationUrl(): string
    {
        return $this->isSandboxMode()
            ? $this->settings->sandboxApiVerificationUrl
            : $this->settings->apiVerificationUrl;
    }

    /**
     * Retrieve payment in sandbox mode?
     *
     * @return bool
     */
    protected function isSandboxMode() : bool
    {
        return $this->settings->sandbox;
    }

    /**
     * Convert status to a readable message.
     *
     * @param $status
     *
     * @return mixed|string
     */
    private function translateStatus($status)
    {
        $translations = [
            '99' => 'انصراف کاربر از پرداخت',
            '88' => 'پرداخت ناموفق',
            '77' => 'لغو پرداخت توسط کاربر',
        ];

        $unknownError = 'خطای ناشناخته رخ داده است. در صورت کسر مبلغ از حساب حداکثر پس از 72 ساعت به حسابتان برمیگردد';

        return array_key_exists($status, $translations) ? $translations[$status] : $unknownError;
    }
}