אינטגרציה עם TripPay
מאמר זה מכיל דוגמה מקיפה לאופן שבו ניתן לשלב עם TripPay.
מומלץ שכבר קראתם את:
- תשלום > מיפוי.
- תשלום > אינטגרציה.
- רכיב אינטרנט לתשלום.
- ממשק API לתשלום.קרא את הקטע בנושא
Create payable contracts
הנה השלבים לשימוש מוצלח ב-TripPay לתשלום עבור הזמנה:
- ודאו שהמוטבים שאתם מזכירים בחוזה ההזמנה מופו.
- תנו לנוסע לבחור את המלאי שהוא רוצה להזמין ולתת לו להתכונן לתשלום.
- צור
payable contract
עם TripPay שמכיל את הפריטים להזמנה. - אפשר לנוסע לשלם באמצעות רכיב האינטרנט של TripPay.
אנו מניחים שכבר השלמתStep 1
וStep 2
ומוכנים ליידע את TripPay על ההזמנה.
יצירת חוזה לתשלום
Section titled “יצירת חוזה לתשלום”:::הערה עבור אל ממשק ה-API של התשלומים כדי ללמוד עוד על הדרישות ליצירת חוזה לתשלום. :::
בַּקָשָׁה
Section titled “בַּקָשָׁה”הנה בקשת JSON לדוגמה הכוללת את כל מה שצריך כדי ליצור עבור חוזה התשלום הראשון שלכם.
{ "user": { "userIdentifier": "191d5729-0b90-4000-85df-1bea7a6e9a01", "firstName": "John", "lastName": "Smith", }, "affiliateAccountIdentifier": "291d5729-0b91-4001-95df-2bec7a6e9a01", "affiliateAccountIdentifierType": "INTERNAL", "displayCurrency": "USD", "traceId": "trace-1", "redirectUrl": "/thank-you", "sourceUrl": "https://www.travel.com", "contractList": [ { "identifier": "191d5729-0b90-4000-8298-72431beb1701", "supplierIdentifier": "191d5729-0b90-4000-8b72-58186a642401", "supplierIdentifierType": "EXTERNAL", "contractItemList": [ { "user": { "userIdentifier": "191d5729-0b90-4000-8596-ed18f9876801", "firstName": "John", "lastName": "Smith", "telephone": "+1 212 555 1212", }, "nameInEnglish": "Deluxe King", "descriptionInEnglish": "This is the best deluxe king that money can buy.", "price": { "amount": 100, "currency": "USD" }, "itinerary": { "startDate": "2024-12-24T00:00:00.000Z", "endDate": "2024-12-25T00:00:00.000Z", "adults": 2 }, "pricingType": "PER_STAY", "type": "LODGING", "payable": "PREPAY", "policy": { "refundable": true }, "externalIdentifier": "room-type-1", "dailyRateList": [ { "date": "2024-12-24", "price": { "amount": 100, "currency": "USD" } } ], "beneficiaryList": [ { "identifier": "account-0", "identifierType": "INTERNAL", "amountDue": { "type": "PERCENTAGE", "percent": 0.015 }, "type": "PLATFORM_FEE" }, { "identifier": "account-1", "identifierType": "INTERNAL", "amountDue": { "type": "PERCENTAGE", "percent": 0.0985 }, "type": "COMMISSION" }, { "identifier": "account-2", "identifierType": "INTERNAL", "amountDue": { "type": "PERCENTAGE", "percent": 0.8865 }, "type": "SALE" } ] } ] } ]}
הֶסבֵּר:
לא נסביר כאן כל נקודת נתונים מכיוון שהיא כבר מכוסה במסמכי ה-API.
- קווים:2 - 7הוא המשתמש האחראי על ההזמנה. ישנם שני סוגים של מזמינים:
- נוֹסֵעַ.
- סוֹכֵן נְסִיעוֹת.
- קווים:8 - 9האם חשבון TripPay מאפשר את ההזמנה? זה יכול להיות:
- חשבון האינטגרטור שלך ב-TripPay.
- אם אתם מנהלים רשת שותפים, זו יכולה להיות רשת השותפים שלכם.
- השתמש ב-
traceId
לקבץ הזמנות מרובות בין ספקים מרובים. בדרך זו ניתן לבטל הזמנה קבוצתית. redirectUrl
מאפשר ל-TripPay לדעת לאיזה דף להפנות לאחר השלמת התשלום.sourceUrl
הוא האתר/אפליקציה שבה בוצעה ההזמנה.
הcontractList
המערך מכיל את הפריט/ים שהנוסע רוצה לרכוש מספקים מרובים. כל פריט מכיל:
- ה
identifier
הוא UUID חוקי שאתה יוצר. - הספק שממנו ברצונך להזמין מלאי.
- המלאי שברצונך להזמין מאותו ספק. כל אלה מצוינים במערך המקונן.
contractItemList
. - כל ערך תחת
contractItemList
מכיל:- משתמש אורחזהו המשתמש שיגיע למקום.
- שם באנגליתשם המלאי בשפה האנגלית.
- תיאור באנגליתתיאור ארוך יותר של המלאי בשפה האנגלית.
- מְחִירמחיר הפריט.
- מַסלוּלמתי יש להזמין פריט זה.
- סוג תמחורכיצד חושב המחיר.
- סוג מלאיאיזה סוג של מלאי זה.
- לתשלוםמתי יש לחייב את הנוסע.כרגע אנו תומכים רק באפשרויות תשלום מיידיות.
- מְדִינִיוּתכלול את כללי מדיניות הביטול.
- רשימת תעריפים יומיתאם הפריט המוזמן הוא חדר, תוכלו לבחור לכלול את עלות החדר עבור כל לילה בו שהה האורח.
- מוטביםיש לכלול את החשבון/חשבונות TripPay שאליהם יש להקצות איזה סכום/סכומים ממחיר הפריט.סכומים קבועים / באחוזים נתמכים.
בשלב זה, אתם מוכנים להטמיע אתPayment Web Component
לאתר שלך ולהציג אותו למשתמש.
<trip-pay id="contract-1"></trip-pay>
מבחינת אינטגרציה, זה כל מה שאתם צריכים לעשות. את כל העבודה הכבדה תעשה TripPay מעתה והלאה.