הכנת המערכות שלך ל-Shop Cash

לפני השקת תהליכי עבודה של Shop Cash עם מערכות צד שלישי, יש לוודא את הדרישות הבאות:

• מערכות ה-ERP, ה-OMS, מילוי ההזמנות, הנהלת החשבונות וההחזרות שלך יכולות לקבל יותר מאמצעי תשלום אחד בהזמנה אחת.
• shop_cash ממופה כאמצעי תשלום שבו קיימים ערכי שער תשלום (gateway).
• ההתייחסות ל-Shop Cash אינה כאל הנחה, כרטיס מתנה או אשראי בחנות.
• ערך ההרשאה נשמר כמחרוזת אטומה באורך משתנה של לפחות 1,024 תווים. אם אפשר, יש להשתמש בשדה טקסט ללא גבולות.
• לכידות (captures), ביטולים והחזרים כספיים מזוהים לפי מזהה עסקה ולא לפי ערך ההרשאה. פעולות לכידה וביטול ב-Admin API משתמשות ב-parentTransactionId, ופעולות של החזר כספי משתמשות ב-parentId.
• המערכות שלך לא מנתחות, מפענחות, מנרמלות, מגבבות (hash) או חותכות את ערכי ההרשאה של Shop Cash.
• המערכות שלך יכולות לטפל בתשלומים (payouts) מקובצים, שבהם שורת shop_cash_credit אחת יכולה לייצג כמה הזמנות.
• תהליך עבודת ההתאמה שלך לא מניח שהזמנה אחת שווה לשורת תשלום אחת.
• תהליך עבודת ההתאמה שלך יכול להתמודד עם כך שהחלק של Shop Cash והחלק של כרטיס האשראי או תשלומי Shop Pay נסלקים בתשלומים שונים.
• תהליך עבודת ההחזר הכספי שלך יכול לעבד החזרים כספיים חלקיים על פני כרטיס, תשלומי Shop Pay ו-Shop Cash.
• יישומי החזרים כספיים יכולים לזכות את עסקת הלכידה של Shop Cash, ולא את עסקת ההרשאה.
• אם הפעלת Shop Campaigns לפני ינואר 2026, תהליך העבודה הפיננסי שלך מטפל בשורת החיוב ההיסטורית של shop_cash_campaign_billing_debit ובשורות חיוב קשורות לקמפיין בנפרד מהכנסות ההזמנה. עלויות של קמפיינים החל מינואר 2026 ואילך יחויבו בחשבון ה-Shopify שלך במקום זאת.

לבדיקת Shop Cash יש מגבלות מכיוון ש-Shop Cash תלוי בחשבונות של קונים ב-Shop, ביתרות של Shop Cash, ב-Shopify Payments ובתשתית הסליקה של Shop Cash.

הדרך האמינה ביותר לאמת אינטגרציה של ארגון מקצה לקצה היא לבצע הזמנת ייצור בעלת ערך נמוך דרך Shop, ולאחר מכן לבצע עבורה החזר כספי. פעולה זו יוצרת עסקאות הזמנה בסביבת ייצור, נתוני לכידה, פעילות תשלומים, עסקאות של החזר כספי ופעילות חיוב של החזר כספי שזורמים דרך Shopify Admin, נתוני Admin API, ייצוא של תשלומים (payouts) ונתוני API של תשלומים.

חנויות פיתוח יכולות לעזור באימות כמה מבני שדות API והיגיון מיפוי, אך הן לא מדמות בצורה אמינה את תהליך התשלום המלא שמקורו ב-Shop, יתרת הקונה, ותהליך הסליקה. מצב בדיקה ושער התשלום Bogus לא יוצרים שורות תשלום (payout) של Shop Cash שזהות לסביבת הייצור מכיוון שהם לא משתמשים בתהליך סליקה חי של Shopify Payments.

בדרך כלל אפשר לבדוק את תהליכי העבודה הבאים בעזרת הזמנת ייצור בעלת ערך נמוך שמופעלת מ-Shop:

• קליטת הזמנה מרובת אמצעי תשלום שכוללת את Shop Cash ואת Shop Pay או תשלומי Shop Pay.
• מיפוי ב-ERP או OMS עבור shop_cash.
• אחסון של ערך ההרשאה המלא של Shop Cash.
• החזרים כספיים חלקיים ומלאים כנגד ההזמנה.
• קליטה של פעילות התשלום shop_cash_refund_debit.
• התאמת תשלומים עבור זיכויים של Shop Cash.
• התנהגות של הזמנה מוקדמת או של לכידה-בעת-מילוי הזמנה, אם החנות שלך משתמשת בלכידה מושהית.
• טיפול של יישום החזרות בהזמנות עם יותר מאמצעי תשלום אחד.

כשמבצעים בדיקה בסביבת ייצור, יש להשתמש בהזמנה בעלת ערך נמוך ולעקוב אחר נהלי הזמנת הבדיקה וההחזר הכספי הפנימיים של החנות שלך.

יש לפנות אל התמיכה של Shopify אם נדרשת לך עזרה באחד מהתרחישים הבאים:

• בדיקת זמינות של Shop Cash עבור שוק שנמצא בשלב של הפצה הדרגתית.
• חקירת לכידה או החזר כספי של Shop Cash שנכשלו.
• חקירת עסקת תשלום (payout) של Shop Cash שחסרה, לאחר מחזור התשלומים הרגיל שלך בתוספת של מחזור תשלום אחד נוסף.
• בדיקה אם ניתן לאשר מחדש הרשאת Shop Cash שבוטלה או שפג תוקפה.
• תכנון השקה עבור תהליך עבודה מורכב של ERP,‏ OMS, הזמנה מוקדמת או מילוי הזמנות.

לפני שמגדילים את נפח ההזמנות של Shop Cash, יש להשלים את הבדיקות הבאות:

• מיפוי של אמצעי תשלום ב-ERP וב-OMS הופעל ואומת עבור shop_cash.
• הזמנה לדוגמה של Shop Cash נקלטה מקצה לקצה, כולל עסקאות הרשאה ולכידה.
• זיכוי של תשלום מ-Shop Cash לדוגמה עבר התאמה מול הזמנת המקור או ההזמנות.
• החזר כספי של Shop Cash לדוגמה עובד ועבר התאמה מול חיוב ההחזר הכספי.
• שורות תשלום מקובצות של Shop Cash נתמכות, או שיש להן תהליך התאמה ידני.
• ההקצאה של החזר כספי חלקי מובנת על ידי צוותי התמיכה והכספים שלך.
• התנהגות של הזמנה מוקדמת, לכידה ידנית ולכידה-בעת-מילוי הזמנה אומתה, במידת הצורך.
• יישומי החזרות יכולים לזהות ולזכות את עסקת הלכידה הנכונה של Shop Cash.
• צוותי התמיכה והכספים יודעים את ההבדל בין היתרה של הלקוח ב-Shop Cash, מבצעים של Shop ופעילות חיוב של Shop Campaigns.

לדרישות של API ושל נתוני הזמנה, יש לעיין בסעיף נתוני הזמנה של Shop Cash ושילובים של צד שלישי. לדרישות של תשלומים (payouts), יש לעיין בסעיף התאמת תשלומים של Shop Cash.