POST
/getState.json۵. استعلام وضعیت پرداخت (GetState)
دریافت وضعیت فعلی یک تراکنش
وضعیت جاری یک paymentNumber را بازمی‌گرداند. برای نمایش وضعیت در سامانه پذیرنده یا پیگیری وقتی Callback دریافت نشده است استفاده می‌شود.
پارامترهای ورودی
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
apiKey | string | required | کلید وب‌سرویس |
paymentNumber | string | required | شناسه پرداخت |
فیلدهای پاسخ
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
status | boolean | required | نتیجه درخواست |
message | string | optional | پیام خطا در صورت عدم موفقیت |
item | object | required | شامل paymentNumber، state، stateLabel و payerCardNumber |
خطاهای احتمالی
| کد | پیام | راه‌حل |
|---|---|---|
| 400 | invalid_payment_number | شماره پرداخت معتبر نیست |
| 400 | invalid_api_key | کلید وب سرویس معتبر نیست |
| 400 | payment_not_found | تراکنش پرداخت آنلاین یافت نشد |
صفحات مرتبط
آیا این صفحه مفید بود؟