API مدفوعات Zyrix
v1.0

// ── Zyrix Payment Types ─────────────────────────────────────────
// Install: npm install @zyrix/types
// Or use these definitions directly in your project

type ZyrixCurrency = "TRY" | "SAR" | "AED" | "KWD" | "QAR" | "EGP" | "IQD";
type ZyrixCryptoAsset = "USDT" | "BTC" | "ETH";
type ZyrixCryptoNetwork = "trc20" | "erc20" | "bep20" | "bitcoin" | "ethereum";
type ZyrixPaymentMethod = "card" | "crypto" | "cod" | "qr" | "tap_to_pay" | "bank_transfer";
type ZyrixLocale = "ar" | "tr" | "en";

type ZyrixPaymentStatus =
  | "requires_payment_method"
  | "requires_confirmation"
  | "requires_action"
  | "processing"
  | "succeeded"
  | "failed"
  | "canceled"
  | "refunded";

interface ZyrixCreatePaymentIntent {
  amount: number;                        // in smallest unit
  currency: ZyrixCurrency;
  payment_method: ZyrixPaymentMethod;
  crypto_asset?: ZyrixCryptoAsset;
  crypto_network?: ZyrixCryptoNetwork;
  merchant_id?: string;
  customer_id?: string;
  order_id?: string;
  description?: string;
  statement_descriptor?: string;         // max 22 chars
  metadata?: Record<string, string>;
  locale?: ZyrixLocale;
  idempotency_key?: string;
  cod_address?: {
    line1: string;
    city: string;
    country: string;
    postal_code?: string;
  };
  split?: Array<{
    merchant_id: string;
    amount: number;
    currency: ZyrixCurrency;
  }>;
}

interface ZyrixPaymentIntent {
  id: string;
  object: "payment_intent";
  status: ZyrixPaymentStatus;
  amount: number;
  currency: ZyrixCurrency;
  amount_received: number;
  payment_method: ZyrixPaymentMethod;
  crypto?: {
    asset: ZyrixCryptoAsset;
    network: ZyrixCryptoNetwork;
    address: string;
    amount_crypto: string;
    rate_locked_until: string;
    qr_code_url: string;
  };
  fee: {
    amount: number;
    currency: ZyrixCurrency;
    rate: string;
    breakdown: {
      processing: number;
      currency_conversion: number;
      network: number;
    };
  };
  net_amount: number;
  settlement_date: string;
  checkout_url: string;
  client_secret: string;
  merchant_id: string;
  order_id?: string;
  metadata?: Record<string, string>;
  created_at: string;
  expires_at: string;
  livemode: boolean;
  next_action?: {
    type: "redirect_to_url";
    redirect_to_url: {
      url: string;
      return_url: string;
    };
  };
}

interface ZyrixWebhookEvent {
  id: string;
  type: string;
  created: number;
  livemode: boolean;
  data: { object: ZyrixPaymentIntent | Record<string, unknown> };
  merchant_id: string;
}

// ── Usage example ───────────────────────────────────────────────
async function createPayment(orderAmount: number, currency: ZyrixCurrency) {
  const intent: ZyrixCreatePaymentIntent = {
    amount: orderAmount * 100,   // convert to kuruş/halala
    currency,
    payment_method: "card",
    locale: "ar",
    metadata: { source: "mobile_app" },
    idempotency_key: `order_${Date.now()}`,
  };

  const response = await fetch("https://api.zyrix.co/v1/payments/intent", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ZYRIX_SECRET_KEY}`,
      "Content-Type": "application/json",
      "X-Idempotency-Key": intent.idempotency_key!,
    },
    body: JSON.stringify(intent),
  });

  const payment: ZyrixPaymentIntent = await response.json();
  return payment;
}