برای توسعه‌دهندگان

یک درخواست، یک لینک پرداخت

REST API ساده با کلید API، وب‌هوک امضاشده برای هر تغییر وضعیت و محیط تست جدا برای آزمایش بدون پول واقعی.

مرجع کامل API همهٔ درخواست‌ها، پارامترها، پاسخ‌ها و کدهای خطا. باز کردن مستندات وب‌هوک‌ها رویداد امضاشده به آدرس سایت شما پس از تایید پرداخت. نحوهٔ اعتبارسنجی افزونهٔ ووکامرس بدون نوشتن کد؛ نصب افزونه و وارد کردن کلید API. راهنمای نصب

شروع سریع

ساخت پرداخت

کلید API سایت را از پنل بردارید و با یک درخواست POST پرداخت بسازید. خریدار را به payment_url بفرستید؛ بقیهٔ کار با صفحهٔ پرداخت است.

کلید را در سرآیند X-API-Key یا Authorization: Bearer بفرستید. با redirect_url خریدار پس از پرداخت به فروشگاه برمی‌گردد. وضعیت را هر زمان با GET /payments/{id}/status بپرسید.

POST /api/v1/payments

curl -X POST https://account.paymenting.io/api/v1/payments \
  -H "X-API-Key: sk_test_••••" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100,
    "currency": "USD",
    "order_id": "48213",
    "callback_url": "https://shop.ir/hook",
    "redirect_url": "https://shop.ir/thanks"
  }'

// پاسخ
{ "payment_url": "https://account.paymenting.io/pay/9b2e41c7",
  "status": "awaiting",
  "expires_at": "…" }

وب‌هوک

از تایید پرداخت باخبر شوید

وقتی پرداخت تایید شد، درخواست POST به callback_url فرستاده می‌شود. امضای سرآیند X-Gateway-Signature را با HMAC-SHA256 متن خام درخواست و کلید مخفی سایت مقایسه کنید.

امضا روی همان بایت‌های بدنه حساب می‌شود؛ پیش از بررسی JSON را بازسازی نکنید. با پاسخ 2xx دریافت را تأیید کنید؛ در غیر این صورت ارسال دوباره تکرار می‌شود. با order_id سفارش را پیدا و فقط یک‌بار پردازش کنید.

webhook.php

$body      = file_get_contents('php://input');
$expected  = hash_hmac('sha256', $body, API_SECRET);
$signature = $_SERVER['HTTP_X_GATEWAY_SIGNATURE'] ?? '';

if (!hash_equals($expected, $signature)) {
    http_response_code(401); exit;
}

$event = json_decode($body, true);
// $event['event']    → "payment.completed"
// $event['order_id'] → شناسهٔ سفارش شما
markOrderPaid($event['order_id']);
http_response_code(200);

محیط تست

پیش از پول واقعی، همه‌چیز را آزمایش کنید

با کلید محیط تست، پرداخت‌ها روی شبکهٔ آزمایشی (Testnet) ساخته می‌شوند. جریان کامل — صفحهٔ پرداخت، تایید شبکه و وب‌هوک — را بدون جابه‌جایی پول واقعی ببینید.

دریافت کلید تست مستندات کامل

کلیدهای تست و اصلی جدا همان API و همان وب‌هوک محدودسازی کلید به IPهای سرور شما

پرسش‌های فنی

آیا افزونهٔ ووکامرس دارید؟

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

محیط تست چطور کار می‌کند؟

در محیط تست (Testnet) پرداخت‌ها روی شبکهٔ آزمایشی انجام می‌شوند و پول واقعی جابه‌جا نمی‌شود. وقتی همه‌چیز درست کار کرد، کلید API اصلی را جایگزین کنید.

وب‌هوک‌ها را چطور اعتبارسنجی کنم؟

هر وب‌هوک امضای HMAC دارد. امضا را با کلید مخفی سایت‌تان دوباره بسازید و مقایسه کنید؛ درخواست بدون امضای درست را نپذیرید.

همین امروز پرداخت رمزارزی را فعال کنید ثبت‌نام چند دقیقه طول می‌کشد. تا اولین فروش هزینه‌ای نمی‌پردازید.

ساخت حساب رایگان