Developers

The current build documents payment intents, invoices, hosted checkout, card-session sandbox routing, Google Pay / Apple Pay tokenized-wallet sandboxes, and webhooks, including signing headers and ready-to-use JSON examples.

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

Create a webhook from the merchant panel to receive events for intent creation, payment success, invoice updates, and KYC reviews.

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

Payload example

{
  "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

When Visa, Mastercard, Google Pay, or Apple Pay is selected on checkout, the platform creates a dedicated card session and redirects the customer to a tokenized sandbox page.

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

A starter Flutter package is now included in the project, ready to be refined and later published on pub.dev as yebrax_pay_flutter. It covers payment-intent creation, hosted-checkout launch, and a ready-made button widget.

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

Native wallet roadmap

At this stage, Google Pay and Apple Pay are modeled as tokenized wallets on top of the card rails. Once live routing is available, the same Flutter package can be wired to a live provider that supports both wallets.

• 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