Skip to content
Academy

Интегриране с TripPay

Тази статия съдържа подробен пример за това как да се интегрирате с TripPay.

Препоръчително е вече да сте прочели:

Ето стъпките за успешно използване на TripPay за плащане на резервация:

  1. Уверете се, че бенефициентите, които споменавате в договора за резервация, са картографирани.
  2. Нека пътникът избере инвентара, който иска да резервира, и го подгответе да плати.
  3. Създайте payable contract с TripPay, който съдържа артикулите за резервация.
  4. Нека пътникът плати, използвайки уеб компонента на TripPay.

Предполагаме, че вече сте завършилиStep 1иStep 2и са готови да уведомят TripPay за резервацията.

Създаване на договор за плащане

Section titled “Създаване на договор за плащане”

Заявка

Section titled “Заявка”

Ето примерна JSON заявка, която включва всичко необходимо за създаването на първия ви платим договор.

{
  "user": {
    "userIdentifier": "191d5729-0b90-4000-85df-1bea7a6e9a01",
    "firstName": "John",
    "lastName": "Smith",
    "email": "[email protected]"
  },
  "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",
            "email": "[email protected]",
            "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е сайтът/приложението, на което е извършена резервацията.

ThecontractListМасивът съдържа артикула(ите), които пътникът иска да закупи от няколко доставчици. Всеки артикул съдържа:

  • Theidentifierе валиден UUID, който генерирате.
  • Доставчикът, от когото искате да резервирате инвентар.
  • Инвентарът, който искате да резервирате от този доставчик. Всички те са посочени във вложения масив.contractItemList.
  • Всеки запис подcontractItemListсъдържа:
    • Гост потребителТова е потребителят, който ще пристигне на място.
    • Име на английскиИмето на инвентара на английски език.
    • Описание на английски езикПо-дълго описание на инвентара на английски език.
    • ЦенаЦената на артикула.
    • МаршрутКога този артикул трябва да бъде резервиран.
    • Вид ценообразуванеКак е била изчислена цената.
    • Тип инвентарКакъв вид инвентар е това.
    • ПлатимоКога пътникът трябва да бъде таксуван.В момента поддържаме само опции за незабавно плащане.
    • ПолитикаВключете правила за политика за анулиране.
    • Дневен списък с цениАко резервираният артикул е стая, можете да изберете да включите цената на стаята за всяка нощувка, в която гостът пребивава.
    • БенефициентиВключете на кой(и) TripPay акаунт(и) да бъде разпределена каква(и) сума(и) от цената на артикула.Поддържат се фиксирани/процентни суми.