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

النسخة الحالية توثق Payment Intents وInvoices وHosted Checkout وWebhooks، مع ترويسات التوقيع ونماذج JSON جاهزة للتكامل.

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

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

X-YebraxPay-Event: payment_intent.succeeded
X-YebraxPay-Delivery: 42
X-YebraxPay-Timestamp: 1710864000
X-YebraxPay-Signature: sha256=<hmac(timestamp.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"
}