POST
/verify.json۴. تأیید نهایی (Verify)
تأیید قطعی تراکنش توسط پذیرنده
وضعیت پرداخت را نزد درگاه قطعی می‌کند و نتیجه نهایی را بازمی‌گرداند. پس از دریافت بازگشت روی callbackUrl، این درخواست باید از سرور پذیرنده ارسال شود.
پارامترهای ورودی
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
apiKey | string | required | کلید وب‌سرویس درگاه |
paymentNumber | string | required | شناسه پرداخت |
invoiceNumber | string | optional | در صورت ارسال باید با شماره فاکتور ثبت‌شده مطابقت داشته باشد |
فیلدهای پاسخ
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
status | boolean | required | نتیجه تأیید — در موفقیت بار اول و تماس‌های بعدی true است |
message | string | optional | پیام توصیفی. بار اول موفق: «پرداخت شما با موفقیت انجام شد». تماس مجدد پس از موفقیت: «پرداخت قبلا با موفقیت تایید شده است» |
referenceNumber | string | optional | شماره پیگیری بانکی |
cardNumber | string | optional | شماره کارت (ماسک یا کامل بر اساس تنظیمات درگاه) |
amount | integer | optional | مبلغ تأییدشده به ریال |
alreadyVerified | boolean | optional | فقط در پاسخ موفق. false: تأیید در همین درخواست. true: پرداخت از قبل موفق بوده و تأیید مجدد انجام نشده است |
خطاهای احتمالی
| کد | پیام | راه‌حل |
|---|---|---|
| 400 | invalid_api_key | کلید وب سرویس معتبر نیست |
| 400 | payment_not_found | تراکنش پرداخت آنلاین یافت نشد |
| 400 | invoice_mismatch | شماره فاکتور مطابقت ندارد |
| 400 | verify_failed | متاسفانه پرداخت تایید نشد |
صفحات مرتبط
آیا این صفحه مفید بود؟