استعلام وضعیت پرداخت | مستندات زرین‌پال

# استعلام وضعیت پرداخت

این متد فقط وضعیت تراکنش مورد نظر شما را اعلام میکند

# ارسال اطلاعات

در مرحله اول پذیرندگان باید پارامترهای موجود در جدول زیر را ، با توجه به نوع داده‌ها و نام فیلد، با متد POST به آدرس مشخص شده ارسال نمایند.

اطلاعات ورودی این متد :

نام	نوع	اجباری	شرح
merchant_id	String	بله	كد 36 كاراكتري اختصاصي پذيرنده
authority	String	بله	آتوریتی تراکنش مورد نظر

پاسخ برگشتی توسط این درخواست به شرح زیر است :

نام	نوع	شرح
status	String	وضعیت تراکنش که ممکن است یکی از این حالات باشد : VERIFIED : وریفای شده PAID : پرداخت شده (وریفای نشده) IN_BANK : درحال پرداخت FAILED : ناموفق (تکمیل نشده) REVERSED : تراکنش ریورس شده
code	Integer	عددی كه نشان دهنده موفق بودن یا موفق نبودن پرداخت است.
message	String	پیام موفقیت آمیز بودن درخواست
errors	Array	در صورت وجود خطا کد خطا و پیام آن را برمیگرداند

نکته

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

https://api.zarinpal.com/pg/v4/payment/inquiry.json

مثال:

نمونه درخواست

PHP
cURL


<?php
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.zarinpal.com/pg/v4/payment/inquiry.json',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "merchant_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "authority": "A000000000000000000000000000xpgr85j5",
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Accept: application/json'
  ),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;

نمونه پاسخ موفق

{
  "data": {
    "status": "PAID", // پرداخت شده (وریفای نشده)
    "code": 100,
    "message": "Success"
  },
  "errors": []
}

نمونه پاسخ ناموفق

{
  "message": "Invalid authority",
  "errors": {
      "authority": [
          "Invalid authority.", // آتوریتی اشتباه
          "-54"
      ]
  }
}

قبلی

unVerified