> For the complete documentation index, see [llms.txt](https://invoice4u.gitbook.io/invoice4u-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://invoice4u.gitbook.io/invoice4u-docs/he/clearing-payments/alternative-payment-methods.md).

# אמצעי תשלום חלופיים

‫אמצעי תשלום חלופיים המחויבים דרך אותה מתודת [`ProcessApiRequestV2`](/invoice4u-docs/he/clearing-payments/process-api-request-v2.md), באמצעות דגלים ייעודיים. הם שונים מסליקת כרטיסים רגילה בהפעלה, בתמיכת הספקים ובהתנהגות השגיאות — התייחסו אליהם כמסלול אינטגרציה נפרד.‬

## ‫דגלי הבקשה‬

‫קבעו בדיוק **אחד** מאלה בבקשת הסליקה:‬

| ‫שדה‬          | ‫טיפוס‬ | ‫תיאור‬                        |
| -------------- | ------- | ------------------------------ |
| `IsBitPayment` | boolean | ‫חיוב באמצעות **ביט**.‬        |
| `IsGooglePay`  | boolean | ‫חיוב באמצעות **Google Pay**.‬ |
| `IsApplePay`   | boolean | ‫חיוב באמצעות **Apple Pay**.‬  |

‫כל שאר שדות הבקשה עובדים כמו ב[בקשת סליקה רגילה](/invoice4u-docs/he/clearing-payments/process-api-request-v2.md) — `Sum`, פרטי לקוח, `ReturnUrl`/`CallBackUrl`, ‏`IsDocCreate` וכו'.‬

## ‫דוגמה — תשלום ביט עם מסמך אוטומטי‬

```http
POST /Services/ApiService.svc/ProcessApiRequestV2 HTTP/1.1
Host: apiqa.invoice4u.co.il
Content-Type: application/json

{
  "request": {
    "Invoice4UUserApiKey": "<api-key>",
    "IsBitPayment": true,
    "Sum": 117.0,
    "FullName": "Israel Israeli",
    "Phone": "0501234567",
    "Email": "israel@example.com",
    "Description": "Order #10045",
    "IsDocCreate": true,
    "ReturnUrl": "https://shop.example/thanks",
    "CallBackUrl": "https://shop.example/api/i4u-callback",
    "IsQaMode": true
  }
}
```

‫התהליך הוא תהליך הדף המתארח: הפנו את הלקוח ל-`ClearingRedirectUrl` המוחזר, שם הוא משלים את התשלום באפליקציית הארנק / חלון התשלום.‬

## ‫מגבלות‬

* ‫**נדרשת הפעלה בחשבון.** Google Pay ו-Apple Pay חייבים להיות מופעלים בחשבון ה-Invoice4U שלכם — אחרת הבקשה נדחית לפני שהיא מגיעה לספק (`ApiGooglePayNotAllowedForUser` ‏316 / `ApiApplePayNotAllowedForUser` ‏317).‬
* ‫**תמיכת ספקים משתנה.** לא כל ספק סליקה תומך בכל ארנק — הזמינות תלויה בחברת הסליקה ובמסוף המוגדרים בחשבונכם. אמתו מול תמיכת Invoice4U אילו אמצעים המסוף שלכם תומך לפני האינטגרציה.‬
* ‫**דף מתארח בלבד.** תשלומי ארנק לא ניתנים לשילוב עם `ChargeWithToken` — הלקוח חייב להשלים את התשלום אינטראקטיבית.‬
* ‫**ללא תשלומים.** חיובי ארנק הם תשלום בודד; אפשרויות התשלומים `Type`/`PaymentsNum` חלות על סליקת כרטיסים בלבד.‬
* ‫מסמכים שנוצרים עבור חיובים אלה רושמים את התשלום בסוג התשלום המתאים (למשל ביט מופיע כסוג תשלום ביט/אחר על המסמך), ושורות [לוג הסליקה](/invoice4u-docs/he/clearing-payments/clearing-logs.md) נושאות את הדגלים `IsBitPayment` / `IsGooglePay` / `IsApplePay` לצורך התאמות.‬

## ‫שגיאות‬

| ‫שגיאה (ID)‬                          | ‫משמעות‬                                                 |
| ------------------------------------- | -------------------------------------------------------- |
| `ApiGooglePayNotAllowedForUser` (316) | ‫Google Pay לא מופעל בחשבון.‬                            |
| `ApiApplePayNotAllowedForUser` (317)  | ‫Apple Pay לא מופעל בחשבון.‬                             |
| `ClearingCompanyUndefined` (8)        | ‫אין חשבון סליקה פעיל, או שהמסוף לא תומך באמצעי המבוקש.‬ |
| `ClearingError` (32)                  | ‫התשלום נדחה / שגיאת ספק — פרטים ב-`Paramters`.‬         |