مستندات فیک‌پال
راهنمای استفاده از API فیک‌پال برای شبیه‌سازی و تست فرآیند های پرداخت
بازگشت به وب‌سایت
پس از پایان عملیات در سمت فیک‌پال، خریدار از درگاه پرداخت به وب‌سایت شما بازگردانده می‌شود. این جابه‌جایی به آدرسی صورت می‌گیرد که شما در مرحله ایجاد صفحه پرداخت، در پارامتر callback_url مشخص کرده بودید.
نحوه ارسال داده‌ها
فیک‌پال اطلاعات تراکنش را از طریق متد GET به آدرس callback شما پیوست می‌کند. این پارامترها برای تایید نهایی تراکنش ضروری هستند.
پارامترهای بازگشتی Query Parameters
پارامتر | نوع | توضیحات |
|---|---|---|
Authority | string | کد منحصربه‌فرد ۳۶ کاراکتری که برای تایید تراکنش (Verify) الزامی است. |
Status | string | وضعیت پرداخت؛ شامل دو مقدار
|
نمونه آدرس بازگشت Callback URL
در صورتی که پرداخت در سمت درگاه با موفقیت انجام شود، کاربر به آدرسی مشابه نمونه زیر هدایت خواهد شد:
http://localhost:5173/verify?Authority=A0000000000000000000000000000xkt1ns2&Status=OKهشدار امنیتی
دریافت پارامتر Status=OK به هیچ عنوان به معنی اتمام فرآیند خرید نیست. شما موظف هستید بلافاصله پس از دریافت این پارامتر، متد تایید تراکنش (Verification) را فراخوانی کنید تا از صحت واریز مبلغ به حساب خود اطمینان حاصل کنید.
اگر مقدار Status برابر با NOK بود، می‌توانید بدون استعلام وضعیت، پیام “پرداخت ناموفق” را به کاربر نمایش دهید.