חשבוניות SLK
פתיחת חשבון

Grow (משולם)

סליקה ב-Grow (משולם) — תשלום שאושר מפיק חשבונית מס קבלה

סליקה ותשלומיםWebhookישראלי

מה צריך

אימות
טוקן משותף?token=
מה מדביקים
טוקן שתדביקו בסוף כתובת ה-Webhook (?token=…)
אירועים
notifyUrl callback (status = 1, statusCode = 2)Webhook: תשלום שאושר
החזרים
חשבונית זיכוי מפיקים ידנית
הזמנת בדיקה
כפתור אחד במסך החיבור שולח הזמנה חתומה לדוגמה
בעמוד הזה

תשלום שאושר ב-Grow (לשעבר משולם) מפיק אוטומטית חשבונית מס קבלה.

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

  1. ב-SLK Invoices: חיבורים → סליקה ותשלומים → Grow (משולם), והעתיקו את הכתובת.
  2. הגדירו סוד (טוקן) משלכם. Grow לא חותמת על ההודעה, והטוקן הוא ההגנה.
  3. הוסיפו לסוף הכתובת ?token= ואחריו הסוד: https://invoice.slk.co.il/api/billing/ecommerce/meshulam/<hookId>?token=<הסוד>.
  4. אם אתם עובדים מול ה-API של Grow: ב-createPaymentProcess הגדירו notifyUrl עם הכתובת המלאה.
  5. אם אתם עובדים עם דפי תשלום, קישורי תשלום או פלאגין: פנו לתמיכה של Grow וביקשו להפעיל Webhook לחשבון עם הכתובת המלאה.
  6. את מספר ההזמנה שלכם העבירו באחד משדות customFields. הוא יופיע בנושא המסמך.
  7. בחרו סוג מסמך ולחצו על "שליחת הזמנת בדיקה".

Developer reference#

  • Endpoint: POST /api/billing/ecommerce/meshulam/<hookId>?token=<secret>. Two shapes are accepted, form-encoded (bracketed keys such as data[sum]) or JSON.
  • Docs: server-to-server callback https://developers.grow.business/reference/server-response (form-encoded, not JSON; status, err, data.*); account webhooks https://developers.grow.business/docs/overview-7 (JSON: transactionCode, paymentSum, paymentDesc, fullName, payerEmail, cardSuffix, paymentDate, webhookKey). Neither page documents a signature.
  • Auth: shared token (?token= or x-slk-token).
  • Issues a document when: for the callback shape status = 1, err empty and data.statusCode = 2 (paid); for the webhook shape a transaction code and a sum exist and it is not a failed recurring charge (error_message / charges_attempts). The sum must be > 0.
  • Idempotency: externalId = data.transactionId (or transactionCode); apiIdentifier = meshulam-<id>. Grow retries the callback; a redelivery returns the same document. Calling Grow's ApproveTransaction is the caller's job; the document is issued whether or not it is called.
Grow fieldDocument
data.sum / paymentSum (shekels)one line + one credit-card payment, ×100 → agorot, taxIncluded: true
data.description / paymentDescline name (fallback "תשלום באתר")
data.fullName / fullNamecustomer name
data.payerEmail / payerEmailcustomer email
data.cardSuffix / cardSuffixpayment cardLast4
data.paymentDate (DD/MM/YY)issue date
first data.customFields.*subject / comments
bash
curl -X POST "https://invoice.slk.co.il/api/billing/ecommerce/meshulam/<hookId>?token=<secret>" \
  -H "content-type: application/x-www-form-urlencoded" \
  --data-urlencode "status=1" --data-urlencode "err=" \
  --data-urlencode "data[transactionId]=145111110" --data-urlencode "data[sum]=269" \
  --data-urlencode "data[statusCode]=2" --data-urlencode "data[fullName]=Michal Avraham" \
  --data-urlencode "data[payerEmail][email protected]" --data-urlencode "data[paymentDate]=21/12/21"

Troubleshooting#

  • 401: הטוקן בכתובת לא זהה לסוד שהגדרתם ב-SLK Invoices.
  • 404: מזהה ה-hook שגוי. העתיקו את הכתובת מחדש.
  • 200 עם skipped: התשלום לא הושלם (status שונה מ-1 או statusCode שונה מ-2), או שזה כשל בחיוב חוזר.
  • לא מגיעה שום הודעה: Webhook בחשבון מופעל רק דרך התמיכה של Grow. notifyUrl נשלח רק בקריאה שיצרה את התשלום.
  • "חסום" / "רדום": החבילה או המכסה החודשית לא מאפשרות הפקה. נסו שוב ידנית מיומן ההזמנות.

פותחים חשבון בדקה, ואז מדביקים את הכתובת.

חברו את Grow (משולם)
חיבור Grow (משולם) לחשבוניות SLK — הוראות התקנה | פורטל המפתחים