هذا الدليل يرشدك خلال دمج مدفوعات InzoPay في موقعك أو تطبيق الويب باستخدام REST API.
المتطلبات
- حساب InzoPay مع توليد مفاتيح API
- وسيلة دفع واحدة على الأقل (محفظة) مضافة
- سيرفر لإجراء طلبات API (لا تطلب من المتصفح بـ Secret Key أبداً)
الخيار 1: روابط الدفع (بدون برمجة)
أسرع دمج. أنشئ رابط دفع وضمّنه كزر:
<a href="https://inzopay.com/pay/YOUR_LINK_SLUG"
target="_blank"
class="pay-btn">ادفع عبر InzoPay</a>الخيار 2: دمج API
لتجربة دفع سلسة مدمجة في موقعك، استخدم الـ API.
الخطوة 1 — احفظ مفتاح API بأمان
# .env
INZOPAY_SECRET=ik_live_sk_xxxxxxxxxxxxالخطوة 2 — أنشئ طلب دفع
POST /api/v1/payments/create
Authorization: Bearer ik_live_sk_xxx
Content-Type: application/json
{
"amount": "50.00",
"currency": "USDT",
"customer_email": "[email protected]",
"redirect_url": "https://yoursite.com/thank-you"
}الخطوة 3 — عالج الـ Webhook
عند اكتمال الدفع، ترسل InzoPay Webhook بحدث payment.paid لـ Endpoint الخاص بك. تحقق من التوقيع وأكمل الطلب.