واجهة المطورين

النسخة الحالية توثق Payment Intents وInvoices وHosted Checkout وCard Session Sandbox وGoogle Pay / Apple Pay sandbox tokens وWebhooks، مع ترويسات التوقيع ونماذج JSON جاهزة للتكامل.

GET https://pay.yebrax.com/api/v1/status
{
  "ok": true,
  "service": "Yebrax Pay",
  "env": "foundation_part6"
}

POST https://pay.yebrax.com/api/v1/payment-intents
Authorization: Bearer yp_live_xxx
{
  "amount": 150.00,
  "currency": "USD",
  "title": "Order #1001",
  "customer_name": "Test Customer",
  "customer_email": "customer@example.com"
}

GET https://pay.yebrax.com/api/v1/payment-intents/pi_xxx
Authorization: Bearer yp_live_xxx

POST https://pay.yebrax.com/api/v1/invoices
Authorization: Bearer yp_live_xxx
{
  "title": "Invoice for March",
  "amount": 250.00,
  "currency": "USD",
  "due_date": "2026-03-31"
}

GET https://pay.yebrax.com/api/v1/invoices/inv_xxx
Authorization: Bearer yp_live_xxx

Webhooks

يمكنك إنشاء Webhook من لوحة التاجر لتستقبل أحداث إنشاء الرابط، نجاح الدفع، تحديث الفاتورة، ومراجعات KYC.

X-YebraxPay-Event: payment_intent.succeeded
X-YebraxPay-Delivery: 42
X-YebraxPay-Timestamp: 1710864000
X-YebraxPay-Signature: sha256=<hmac(timestamp.payload)>

مثال Payload

{
  "event": "invoice.paid",
  "object_type": "invoice",
  "object_public_id": "inv_123",
  "merchant_id": 7,
  "data": {
    "invoice": {
      "public_id": "inv_123",
      "invoice_no": "INV-0001",
      "status": "paid"
    },
    "paid_at": "2026-03-19 18:00:00"
  },
  "created_at": "2026-03-19T15:00:00Z"
}

Sandbox card session

عند اختيار Visa أو Mastercard من صفحة الدفع، تنشئ المنصة Card Session منفصلة وتحوّل العميل إلى صفحة اختبار خاصة بالبطاقة.

POST https://pay.yebrax.com/checkout/pi_xxx/pay
payment_method_code=google_pay
sandbox_outcome=pending

# Redirects to
GET https://pay.yebrax.com/checkout/pi_xxx/card/cs_xxx

Test tokens

Visa
- YP-VISA-APPROVE
- YP-VISA-3DS
- YP-VISA-DECLINE
- YP-VISA-REVIEW

Mastercard
- YP-MC-APPROVE
- YP-MC-3DS
- YP-MC-DECLINE
- YP-MC-REVIEW

Google Pay
- YP-GP-VISA-APPROVE
- YP-GP-MC-APPROVE
- YP-GP-DECLINE
- YP-GP-REVIEW

Apple Pay
- YP-AP-VISA-APPROVE
- YP-AP-MC-APPROVE
- YP-AP-DECLINE
- YP-AP-REVIEW

Flutter SDK starter

أضفنا ضمن المشروع حزمة Flutter أولية جاهزة للتنظيف والنشر لاحقًا على pub.dev باسم yebrax_pay_flutter، وتغطي إنشاء Payment Intent وفتح Hosted Checkout ومكوّن زر جاهز.

sdk/flutter/yebrax_pay_flutter/
lib/
example/
pubspec.yaml
README.md

Native wallet roadmap

Google Pay وApple Pay في هذه المرحلة مبنيّان كطبقة tokenized wallets فوق card rails. وعند الربط الحقيقي سنربط الـ package نفسه مع مزود live يدعم الشبكتين.

• Hosted checkout

• Payment intents

• Invoices

• Webhook signing + retries

• Card-session sandbox routing

• Provider abstraction for Visa / Mastercard + tokenized wallets

• Merchant-managed API keys

• Flutter package starter for pub.dev