API & SDK

واجهة برمجة للمبدعين

واجهة برمجة REST مع OpenAPI 3.1 ومفاتيح idempotency وترقيم cursor و SDK في JavaScript و Python و PHP و Ruby و Go و C#.

احصل على مفاتيح API اقرأ الوثائق

<150ms

زمن استجابة API P50

99.95%

SLA وقت التشغيل

SDK رسمية

مواصفات OpenAPI 3.1
مفاتيح idempotency
ترقيم cursor
مصادقة Bearer
webhooks HMAC
Sandbox + بطاقات اختبار
6 SDK رسمية
حد 1,000 req/ثانية
SLA وقت تشغيل 99.95٪

إنشاء دفعة

نقطة نهاية واحدة، ثلاثون طريقة

أرسل POST لمورد واحد ويتولى Baynoy الباقي — البطاقة وApple Pay وGoogle Pay. حدّد عملة الوجهة وسنوجّه التحويل إلى بنكك أو محفظتك عند التسوية.

Idempotency-Key يمنع الشحن المزدوج عند إعادة المحاولة
ترقيم cursor للتقارير عالية الحجم
تحدي 3DS مضمن عبر checkout_url
مفاتيح Sandbox لا تلمس أموالاً حقيقية أبداً

طلب

POST /v1/payments
Authorization: Bearer sk_live_••••
Idempotency-Key: 7a1f2e

{
  "amount": 125000,
  "currency": "EUR",
  "payout":  { "type": "bank", "currency": "TRY" },
  "methods": ["card","usdc","sepa"],
  "metadata": { "patient_id": "p_8821" }
}

استجابة

{
  "id": "pmt_a7c91...",
  "status": "requires_action",
  "checkout_url": "https://pay.baynoy.com/c/a7c91"
}

بداية سريعة

# No SDK to install — it's a plain REST API.
# Create a payment link from any HTTP client:
curl https://baynoy.com/api/v1/payment-links \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Invoice 0042","amount":2000,"currency":"USD"}'

REST API

استدعها من أي لغة

واجهة REST بسيطة مع مصادقة Bearer — لا حاجة لتثبيت أي SDK. استدعها عبر curl أو fetch أو requests أو أي عميل HTTP. جاهزة للإنتاج: استجابات مُؤرَّخة الإصدار، إعادات محاولة آمنة (idempotent)، Webhooks موقَّعة، وتقسيم صفحات بالمؤشر.

استجابات مستقرة ومُؤرَّخة الإصدار عبر ترويسة Baynoy-Version
Idempotency-Key مع كل POST — إعادة المحاولة لا تخصم مرتين أبدًا
Webhooks موقَّعة بـ HMAC-SHA256 (t=…,v1=…)
تقسيم صفحات بالمؤشر على كل نقطة قائمة

اقرأ الوثائق

Webhooks

أحداث يمكنك الوثوق بها

كل webhook موقع بـ HMAC SHA-256، يُعاد محاولته بـ backoff أسي لمدة تصل إلى 7 أيام، ويمكن تصفحه في لوحة القيادة الخاصة بك مع سجل request / response كامل. أعد تشغيل أي حدث سابق بنقرة واحدة.

حمولات موقعة بـ HMAC SHA-256
8 أنواع أحداث تغطي دورة حياة الدفع الكاملة
Backoff أسي حتى 7 أيام
إعادة تشغيل بنقرة واحدة من لوحة القيادة

إدارة نقاط النهاية

حدث موقع

POST /your-endpoint
Baynoy-Signature: t=1716210000,v1=8b3...
Content-Type: application/json

{
  "id": "evt_2zX...",
  "type": "payment.succeeded",
  "data": { "object": { "id": "pmt_a7c91..." } }
}

احصل على مفتاح، أرسل دفعة

تُسلم مفاتيح Sandbox فوراً. يُفتح الإنتاج بعد التحقق من Tier 1.

احصل على مفاتيح API اقرأ الوثائق