# ریورس تراکنش
با استفاده از این متد میتوانید تراکنش های موفقی که از پرداخت آنها نهایت ۳۰ دقیقه گذشته باشد را بدون کارمزد به حساب خریدار سریعا استرداد بزنید
جهت استعلام وضعیت تراکنش در ۳۰ دقیقه اول از متد استعلام وضعیت تراکنش استفاده کنید.
مهم
برای استفاده از این سرویس باید حتما برای درگاه آی پی سرور خود را ست کنید.
در غیر این صورت خطای 62- دریافت میکنید
برای تنظیم آی پی سرور به تنظیمات درگاه مراجعه نمایید
# ارسال اطلاعات
در مرحله اول پذیرندگان باید پارامترهای موجود در جدول زیر را ، با توجه به نوع داده‌ها و نام فیلد، با متد POST به آدرس مشخص شده ارسال نمایند.
اطلاعات ورودی این متد :
| نام | نوع | اجباری | شرح |
|---|---|---|---|
| merchant_id | String | بله | كد 36 كاراكتري اختصاصي پذيرنده |
| authority | String | بله | آتوریتی تراکنش مورد نظر |
پاسخ برگشتی توسط این درخواست به شرح زیر است :
| نام | نوع | شرح |
|---|---|---|
| code | Integer | عددی كه نشان دهنده موفق بودن یا موفق نبودن پرداخت است. |
| message | String | پیام Reversed به معنای موفقیت آمیز بودن درخواست |
| errors | Array | در صورت وجود خطا کد خطا و پیام آن را برمیگرداند |
- نمونه پاسخ موفق
{
"data": {
"code": 100,
"message": "Reversed"
},
"errors": []
}
نکته
برای مشاهده خطا ها به لیست خطا ها مراجعه نمایید
https://api.zarinpal.com/pg/v4/payment/reverse.json
مثال:
- نمونه درخواست
curl -X POST \
https://api.zarinpal.com/pg/v4/payment/reverse.json \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
"merchant_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"authority": "A000000000000000000000000000xpgr85j5",
}'
- نمونه خطا ها
- 60-
- 61-
- 62-
- 63-
{
"data": {},
"errors": {
"message": "Session can not be reversed with bank.",
"code": -60,
"validations": []
}
}