חיבור Tranzila לחשבוניות SLK — הוראות התקנה

כל עסקה מאושרת ב-Tranzila מפיקה אוטומטית חשבונית מס קבלה, דרך דף ה-Notify של המסוף.

התקנה (5 דקות)#

ב-SLK Invoices: חיבורים → סליקה ותשלומים → Tranzila, והעתיקו את הכתובת.
הגדירו סוד (טוקן) משלכם. Tranzila לא חותמת על ההודעה, והטוקן הוא ההגנה.
הוסיפו לסוף הכתובת ?token= ואחריו הסוד: https://invoice.slk.co.il/api/billing/ecommerce/tranzila/<hookId>?token=<הסוד>.
ב-Tranzila הגדירו את הכתובת המלאה כ-Notify URL בהגדרות המסוף או של דף התשלום. אפשר גם להעביר אותה בכל תשלום בפרמטר notify_url_address.
ודאו ששיטת ההחזרה (Return Method) מוגדרת ל-POST.
בחרו סוג מסמך ולחצו על "שליחת הזמנת בדיקה".

Developer reference#

Endpoint: POST /api/billing/ecommerce/tranzila/<hookId>?token=<secret> (application/x-www-form-urlencoded; JSON also parsed).
Docs: https://docs.tranzila.com/docs/payments-and-billing/iframe-integration-directng (notify_url_address and fields), https://docs.tranzila.com/docs/vibe-coding/closing-an-order-in-base44-using-notify-page (POST, form-urlencoded).
Auth: shared token (?token= or x-slk-token). No signature is documented by Tranzila.
Issues a document when: Response is a run of zeros (000/0), currency is 1/ILS (or absent), sum > 0, and a transaction id exists. Anything else is acknowledged with skipped.
Idempotency: externalId = transaction_id (fallback index); apiIdentifier = tranzila-<id>.

Tranzila field	Document
`sum` (shekels string)	one line + one credit-card payment, ×100 → agorot, `taxIncluded: true`
`pdesc`	line name (fallback "תשלום באתר")
`contact`	customer name
`email`	customer email
`myid`	`customerUniqueId`
`ccno`	payment `cardLast4`
`orderid`	subject / comments

bash

curl -X POST "https://invoice.slk.co.il/api/billing/ecommerce/tranzila/<hookId>?token=<secret>" \
  -H "content-type: application/x-www-form-urlencoded" \
  --data "Response=000&transaction_id=5840217&index=312&sum=236.00&currency=1&contact=Yossi+Levi&[email protected]&pdesc=subscription&ccno=4580"

Troubleshooting#

401: הטוקן בכתובת לא זהה לסוד שהגדרתם ב-SLK Invoices.
404: מזהה ה-hook שגוי. העתיקו את הכתובת מחדש.
200 עם skipped: העסקה נדחתה (Response שונה מ-000), לא בשקלים, או בלי סכום. זו התנהגות תקינה.
המסמך לא נוצר אבל התשלום עבר: בדקו ש-Notify URL מוגדר, ושהוא מגיע ב-POST. אפשר לראות כל ניסיון ביומן ההזמנות.
"חסום" / "רדום": החבילה או המכסה החודשית לא מאפשרות הפקה. נסו שוב ידנית מיומן ההזמנות אחרי השדרוג.

מה צריך

התקנה (5 דקות)#

Developer reference#

Troubleshooting#