חיובים חד-פעמיים (One-Time Payments) - Base44

const SplitzClient = require('splitz-payments');

const splitz = new SplitzClient({
  apiKey: 'YOUR_API_KEY_HERE'
});

  // יצירת לינק
  const options = {
    payment_link_uid: 'xxx',
    customer_email: '[email protected]'
  };

 const result = await splitz.paymentLinks.generate(options);
 console.log(result.url);

// return the url to the frontend using res.json({....

const SplitzClient = require('splitz-payments');

const splitz = new SplitzClient({
  apiKey: 'YOUR_API_KEY_HERE'
});

 // בדיקת תשלום
 const isPaidResult = await splitz.orders.isPaid('order_uid');
 console.log(isPaidResult.paid); // boolean

  // שליפת הזמנה
 const orderResult = await splitz.orders.get('order_uid');
 console.log(orderResult.order.email);

// validate if the order was paid using the parmas the backend function recived.
// then return the reuslt to the frontend.

?order_uid=order_xxx

{
  uid: string;              // מזהה ייחודי של ההזמנה
  email: string;           // אימייל הלקוח
  price: number;           // מחיר (לדוגמה: 499)
  currency: string;        // מטבע (ILS)
  status: string;          // סטטוס ההזמנה
  is_paid: boolean;        // האם שולם?
  paid_at: string | null;  // תאריך תשלום (ISO format)
  createdAt: string;       // תאריך יצירה
}

אני רוצה להוסיף כפתור "קנה עכשיו" לדף המוצר שלי.

כשלוחצים עליו:
1. יצור לינק תשלום חד-פעמי ב-Splitz
2. יעביר את הלקוח לדף התשלום
3. אחרי תשלום מוצלח - יאמת ויתן לו גישה למוצר

השתמש בחבילת NPM: splitz-payments

צור Backend Function שעושה:

```javascript
const SplitzClient = require('splitz-payments');

const splitz = new SplitzClient({
  apiKey: 'YOUR_API_KEY_HERE' // החלף!
});

// יצירת לינק תשלום
const paymentLink = await splitz.paymentLinks.generate({
  payment_link_uid: 'xxx', // החלף ל-Payment Link שלך
  customer_email: 'מייל המשתמש המחובר'
});

לאחר מכן תוכל להחזיר לצד הלקוח את הלינק שחזר מהמשתנה paymentLink

---

## טיפול בשגיאות

הספרייה מספקת error classes ייעודיים:

```javascript
const { errors } = require('splitz-payments');

try {
  const status = await splitz.orders.isPaid('order_xxx');
  
} catch (error) {
  if (error instanceof errors.NotFoundError) {
    console.error('❌ הזמנה לא נמצאה');
    alert('ההזמנה לא קיימת במערכת. צור קשר עם התמיכה.');
    
  } else if (error instanceof errors.AuthenticationError) {
    console.error('❌ API key לא תקין');
    
  } else if (error instanceof errors.ForbiddenError) {
    console.error('❌ אין הרשאה לגשת להזמנה זו');
    
  } else if (error instanceof errors.SplitzAPIError) {
    console.error('❌ שגיאת API:', error.message);
    console.error('סטטוס:', error.statusCode);
  }
}