Pay2Pay
امکانات نحوه کار مستندات افزونه وردپرس تعرفه‌ها تماس
ورود شروع رایگان

مستندات API

اگر سایت شما وردپرسی است، پیشنهاد می‌کنیم از پلاگین رسمی ما استفاده کنید تا همه‌چیز بدون کدنویسی راه‌اندازی شود. اگر سیستم اختصاصی دارید (Laravel / Node / PHP / ...)، از همین مستندات برای اتصال مستقیم استفاده کنید.

کدوم روش مناسب شماست؟
وردپرس / ووکامرس: سریع‌ترین و پیشنهادی‌ترین روش، استفاده از پلاگین است.
کدنویسی اختصاصی: این صفحه را دنبال کنید و با API لینک پرداخت بسازید و وبهوک را دریافت کنید.
مشاهده پلاگین وردپرس پشتیبانی

۱) ایجاد فاکتور (Create Invoice)

فاکتور ساخته می‌شود و لینک پرداخت برمی‌گردد. این درخواست هم JSON و هم Form را می‌پذیرد.
نکته: webhook_url اختیاری است و برای اتصال‌های اختصاصی پیشنهاد می‌شود. اگر ارسال نشود، برای سازگاری با پلاگین، وبهوک به مسیر ووکامرس ارسال می‌شود.

POST /invoice/validate.php
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 بخوانید.

پاسخ نمونه

لینک پرداخت را به کاربر نمایش دهید یا ریدایرکت کنید.

200 OK
HTTP/1.1 200 OK
{
  "status": "success",
  "invoice_url": "https://pay.overapi.ir/invoice/UNIQUE_ID_HERE",
  "amount": 100030
}

۲) وبهوک تایید پرداخت (Webhook)

پس از تایید پرداخت، وبهوک به مقصد شما POST می‌شود. اگر webhook_url فرستاده باشید به همان آدرس، در غیر این صورت برای ووکامرس به /?wc-api=mygateway_webhook. در سمت خود با unique_id یا description سفارش را پیدا و «پرداخت‌شده» کنید.

توکن/دسترسی می‌خواهی؟
ثبت‌نام کن و از پنل، توکن فروشگاه و تنظیمات دامنه را انجام بده.
ثبت‌نام پلاگین وردپرس