ציון סוגי תשלום

דרישות מוקדמות

כדי להשלים את המדריך, עליכם להשלים את השלבים הבאים:

1. הבנה של מדיניות התשלומים שלנו.
2. השלמת החלק של ייצוא הפידים משילוב E2E.

אלה סוגי התשלום שנתמכים בתוסף הזה:

1. תשלום מראש
2. אין עמלת הצגה / עמלת ביטול
3. הפקדה
4. נדרש כרטיס אשראי

כל התרחישים לדוגמה של תשלומים הם הארכות של התרחיש לדוגמה 'ללא תשלומים' או 'תשלום בזמן ההגעה' (שלא מצריך הגדרת תשלום). לכן, המדריך הזה יתחיל בתיאור של ההגדרות האלה ויתייחס להגדרות אחרות כתוספים.

תשלום מראש

ההגדרה הזו משמשת לציון שהסכום לתשלום על השירות צריך להיות מלא בזמן ההזמנה. התשלום מראש מצוין ברמת הזמינות באמצעות השדה payment בפיד Avaibility.

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

{
  "availability": [{
    "merchant_id": "dining-A",
    "service_id": "reservation",
    "start_sec": 1535853600,
    "duration_sec": 2700,
    "spots_total": 2,
    "spots_open": 2,
    "resources": {
    "room_id": "A-dining-room",
    "room_name": "Wine Tasting Room",
    "party_size": 2,
    "prepayment": {
      "price_info": {
        "price": {
          "price_micros": 200000000,
          "currency_code": "USD",
          },
        "price_type": "PER_PERSON"
        }
      }
    }
  }]
}

עמלת אי-הגעה

אפשר לחייב את המשתמש על עמלות על אי-הגעה אם הוא לא השתתף בהזמנה או אם הוא מבטל אחרי חלון הביטול. אם לא תציינו חלון ביטול, ברירת המחדל תהיה שעת ההתחלה של החריץ.

כדי לציין עמלת אי-הצגה, בפיד השירות צריך לכלול את השדה no_show_fee, כמו בדוגמה הבאה:

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    },
    "scheduling_rules": {
        "min_advance_online_canceling": 14400,
    },
    "no_show_fee": {
        "fee": {
            "price_micros": 25000000,
            "currency_code": "USD"
        },
        "fee_type": "FIXED_RATE_DEFAULT"
    }
}

בדוגמה, השותף או המוכר מורשים לגבות חיוב בתעריף קבוע של 25$, כפי שמצוין בשדה no_show_fee.fee.price_micros, במקרה שהבעלים הממונה לא משתתף בפגישה. יכול להיות שתחויבו בתשלום הזה גם אם המשתמש יבטל את הפגישה תוך 4 שעות (14400 שניות) לפני הפגישה, כפי שצוין בשדה scheduling_rules.min_advance_online_canceling.

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

אפשר גם להגדיר את החיוב על אי-הגעה לכל אדם על ההזמנה. במקרה הזה, אפשר להגדיר את no_show_fee.fee.fee_type לערך PER_PERSON.

הפקדה

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

כדי לציין הפקדה, צריך לכלול בפיד השירות את השדה deposit, כמו בדוגמה הבאה:

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    },
    "scheduling_rules": {
        "min_advance_online_canceling": 86400,
    },
    "deposit": {
        "deposit": {
            "price_micros": 25000000,
            "currency_code": "USD",
            "min_advance_cancellation_sec": 14400,
        },
        "deposit_type": "FIXED_RATE_DEFAULT"
    }
}

בדוגמה הזו, השדה min_advance_online_canceling מגדיר את חלון הביטול והקוד deposit.min_advance_cancellation_sec מגדיר מתי ניתן לקבל החזר כספי על ההפקדה. שימו לב: בדוגמה הבאה, הפקדה יכולה לציין זמן ביטול בנפרד מתנאי ההחזר הכספי. במקרה כזה, המשתמש יוכל לבטל את השירות אונליין עד 24 שעות מראש (86,400 שניות). כך מובטח שהמוכר יקבל הודעה ישירות על ביטולים מאוחרים. עם זאת, יכול להיות שהמשתמש עדיין יהיה זכאי להחזר כספי בהפקדה שלו עד 4 שעות מראש (14,400 שניות) לפני ההזמנה (על ידי יצירת קשר איתך או עם המוכר לביטול ההזמנה). ההחזר יוצג בתנאים בקופה ובהודעת האישור באימייל.

במאמר שינוי תמחור ברמת הזמינות מוסבר איך אפשר להגדיר הפקדות ברמת הזמינות.

חשוב גם לשים לב שבדומה לעמלות על אי-הגעה, אפשר לחייב את הפיקדון בתעריף קבוע או בתעריף לאדם. במקרה כזה, ההפקדה תתבצע בתעריף קבוע של 25$, כפי שצוין ב-"deposit_type": "FIXED_RATE_DEFAULT". אם ההזמנה כוללת מספר אנשים, אפשר לציין את ההפקדה כהפקדה לאדם באמצעות הגדרת "deposit_type": "PER_PERSON".

נדרש כרטיס אשראי

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

כדי לדרוש שכרטיס אשראי יסופק בזמן התשלום, בשדה require_credit_card צריך להיות REQUIRE_CREDIT_CARD_ALWAYS.

{
    "merchant_id": "merchant-1",
    "service_id": "reservation",
    "name": "reservation",
    "description": "Food reservation",
    "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}

שינוי התמחור ברמת הזמינות

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

• המחירים מופחתים בימי שלישי ועולים בימי שבת.
• לא חלות עמלות על השתתפות במופעים על זמינות בין 17:00 ל-19:00.
• דרוש הפקדות עבור מספר אנשים גדול מ-6.
• כדי לבצע הזמנות בחדר מסוים, יש להשתמש בכרטיס אשראי.

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

סוג תשלום	הגדרת פיד	ניתן לעקוף את הבעיה?
תשלום מראש	Availability.prepayment	לא ניתן לבטל
ללא עמלת הצגה	Service.no_show_fee	Availability.no_show_fee
הפקדה	Service.deposit	Availability.deposit