اگر سایت شما وردپرسی است، پیشنهاد میکنیم از پلاگین رسمی ما استفاده کنید تا همهچیز بدون کدنویسی راهاندازی شود. اگر سیستم اختصاصی دارید (Laravel / Node / PHP / ...)، از همین مستندات برای اتصال مستقیم استفاده کنید.
فاکتور ساخته میشود و لینک پرداخت برمیگردد. این درخواست هم JSON و هم Form را میپذیرد.
نکته: webhook_url اختیاری است و برای اتصالهای اختصاصی پیشنهاد میشود.
اگر ارسال نشود، برای سازگاری با پلاگین، وبهوک به مسیر ووکامرس ارسال میشود.
POST https://pay.overapi.ir/invoice/validate.php Content-Type: application/json Accept: application/json { "token": "STORE_TOKEN_XXXXXXXX", "amount": 100000, "callback": "https://merchant.example.com/payment/callback", "webhook_url": "https://merchant.example.com/api/overapi/webhook", "description": "order_id=12345" }
مبلغ نهایی ممکن است برای جلوگیری از تداخل پرداختها تغییر کند؛ همیشه مبلغ نهایی را از خروجی API بخوانید.
لینک پرداخت را به کاربر نمایش دهید یا ریدایرکت کنید.
HTTP/1.1 200 OK { "status": "success", "invoice_url": "https://pay.overapi.ir/invoice/UNIQUE_ID_HERE", "amount": 100030 }
پس از تایید پرداخت، وبهوک به مقصد شما POST میشود. اگر webhook_url فرستاده باشید به همان آدرس،
در غیر این صورت برای ووکامرس به /?wc-api=mygateway_webhook.
در سمت خود با unique_id یا description سفارش را پیدا و «پرداختشده» کنید.