Confirm Transfer Booking Instantly with Rate Key

This method will allow you to confirm ratekey.

Parameters

Name

Description

Accept

string

( header )

*required application/json

Accept - Encoding

string

( header )

*required gzip

Authorization

string

( header )

*required Your API Key

*required Your PID Key

Customer-Ip

string

( header )

*required IP address of the customer, as captured by your integration. Send IPV4 addresses only.

Ensure your integration passes the customer’s IP, not your own. This value helps determine their location and other settings.

Also used for fraud recovery and other important analytics.

Definition and examples of request body of Booking operation

action

string

( query )

*required "booking" as a parameter

holder

object

required

Booking holder/lead passenger information

(1.1)name

string

required

Lead passenger first name

(1.2)surname

string

required

Lead passenger last name

(1.3)email

string

required

Lead passenger contact email

(1.4)phone

string

required

Passenger phone number

transfers

Array of transfer elements

required

List of requested transfer services

rateKey

string

required

Rate key to be confirmed taken from the availability step

transferDetails

Array of transfer details elements

required

Information about the ride from which the transfer will pick up passengers.

type

string

required

Ride type. Possible values:FLIGHT/CRUISE/TRAIN

direction

string

required

Ride direction. Possible values:ARRIVAL/DEPARTURE

companyName

string

required

Indicates the name of the company which operates the ride transport.

NOTE: Normally used in ship transports.

code

string

required

Ride identification number(e.g., flight number).

NOTE: The character limit in this field is 7 characters.

remark

string

Optional

Comments. NOTE: The character limit in this field is 2000 characters.

price

Double

( query )

totalAmount

currency

string

Currency

REQUEST

API Endpoint: https://www.abengines.com/api/v1/travel-api/transfer-booking/

header: array(
'Content-Type:application/json',
'Accept-encoding: gzip',
'PID:'ADD-PID-KEY',
'x-api-key:'ADD-API-YOUR-KEY'
);

Oneway POST RQ: 
{
  "action": "booking",
  "price": "10232",
  "currency": "INR",
  "remark": "Test Booking",
  "holder": {
    "name": "Test",
    "surname": "Booking",
    "email": "praveen@thewebconz.com",
    "phone": "8802273456"
  },
  "transfers": [
    {
      "rateKey": "DEPARTURE|ATLAS|5643|IATA|CIA|2023-08-12|06:40|2023-08-12|10:00|1~0~0||2|248510|ROE PRV PRM H24|248510|ROE PRV PRM H24|207|PRVT|7|CR|PRM|10632.15|ROMA AREA|AERO CIAMP|23229|1391|ROE|SIMPLE|c4d875044c4f29113837c8f153f4d8c5",
      "transferDetails": [
        {
          "type": "FLIGHT",
          "direction": "DEPARTURE",
          "code": "SPIJ45",
          "companyName": null
        }
      ]
    }
  ]
}

===========================

Roundway POST RQ: 
{
  "action": "booking",
  "price": "10232",
  "currency": "INR",
  "remark": "Test Booking",
  "holder": {
    "name": "Mukesh",
    "surname": "Kumar",
    "email": "mukesh@thewebconz.com",
    "phone": "09818794343"
  },
  "remark": "Booking remarks go here",
  "transfers": [
    {
      "rateKey": "ARRIVAL|IATA|HRG|ATLAS|110618|2023-08-10|10:00|2023-08-10|10:00|1~0~0||99|21142|HRG SHARED 23|21142|HRG SHARED 23|138|SHRD|M|MNBS|STND|212.64|HRG|HURGHADA|22323|292|HRG|SIMPLE|d12426e06d4037a05eb23fdee9597b76",
      "transferDetails": [
        {
          "type": "FLIGHT",
          "direction": "ARRIVAL",
          "code": "SPIJ45",
          "companyName": null
        }
      ]
    },
    {
      "rateKey": "DEPARTURE|ATLAS|110618|IATA|HRG|2023-08-11||2023-08-11|11:00|1~0~0||99|21142|HRG SHARED 23|21142|HRG SHARED 23|138|SHRD|M|MNBS|STND|212.64|HURGHADA|HRG|22304|292|HRG|SIMPLE|63dea8243cbe2d5ebf55635f575f5053",
      "transferDetails": [
        {
          "type": "FLIGHT",
          "direction": "DEPARTURE",
          "code": "SPIJ46",
          "companyName": null
        }
      ]
    }
  ]
}

Response

The API returns an HTTP response, which generally includes the result of the request invocation

{
  "status": 200,
  "status_message": "OK",
  "responseData": {
    "bookings": [
      {
        "reference": "207-9502653",
        "bookingFileId": null,
        "creationDate": "2023-07-29T11:09:09",
        "status": "CONFIRMED",
        "modificationsPolicies": {
          "cancellation": true,
          "modification": true
        },
        "holder": {
          "name": "Test",
          "surname": "Booking",
          "email": "praveen@thewebconz.com",
          "phone": "8802273456"
        },
        "transfers": [
          {
            "id": 1,
            "rateKey": "DEPARTURE|ATLAS|5643|IATA|CIA|2023-08-12|06:40|2023-08-12|10:00|1~0~0||2|248510|ROE PRV PRM H24|248510|ROE PRV PRM H24|207|PRVT|7|CR|PRM|10632.15|ROMA AREA|AERO CIAMP|23229|1391|ROE|SIMPLE|c4d875044c4f29113837c8f153f4d8c5",
            "status": "CONFIRMED",
            "transferType": "PRIVATE",
            "vehicle": {
              "code": "CR",
              "name": "Car"
            },
            "category": {
              "code": "PRM",
              "name": "Premium"
            },
            "pickupInformation": {
              "from": {
                "code": "5643",
                "description": "Sistina",
                "type": "ATLAS"
              },
              "to": {
                "code": "CIA",
                "description": "Rome, Ciampino Airport",
                "type": "IATA"
              },
              "date": "2023-08-12",
              "time": "06:40:00",
              "pickup": {
                "address": "Via Sistina,136  ",
                "number": null,
                "town": "ROME",
                "zip": "00187",
                "description": "You will be picked up at the hotel reception. If you are unable to locate the driver/agent, please call KOI TECHNOLOGIES on +971 567562977 (WhatApp available), +971 45754333. Please do not leave the pick-up area without having contacted the agent/driver first. If the supplier doesn't answer the phone, please call our emergency telephone number listed at the bottom of the voucher before leaving the pick-up area.",
                "altitude": null,
                "latitude": 41.904008,
                "longitude": 12.487254,
                "checkPickup": {
                  "mustCheckPickupTime": false,
                  "url": null,
                  "hoursBeforeConsulting": null
                },
                "pickupId": 23229,
                "stopName": "HOTEL RECEPTION",
                "image": null
              }
            },
            "paxes": [
              {
                "type": "ADULT",
                "age": 30
              }
            ],
            "content": {
              "vehicle": {
                "code": "CR",
                "name": "Car"
              },
              "category": {
                "code": "PRM",
                "name": "Premium"
              },
              "images": [
                {
                  "url": "http://media.activitiesbank.com/giata/transfers/TRD/small/prvt-prm-cr.png",
                  "type": "SMALL"
                },
                {
                  "url": "http://media.activitiesbank.com/giata/transfers/TRD/medium/prvt-prm-cr.png",
                  "type": "MEDIUM"
                },
                {
                  "url": "http://media.activitiesbank.com/giata/transfers/TRD/large/prvt-prm-cr.png",
                  "type": "LARGE"
                },
                {
                  "url": "http://media.activitiesbank.com/giata/transfers/TRD/extralarge/prvt-prm-cr.png",
                  "type": "EXTRALARGE"
                }
              ],
              "transferDetailInfo": [
                {
                  "id": "ER",
                  "name": "Exclusive ride for you",
                  "description": null,
                  "type": "GENERAL_INFO"
                },
                {
                  "id": "DTDS",
                  "name": "Door to door service",
                  "description": null,
                  "type": "GENERAL_INFO"
                },
                {
                  "id": "M&GS",
                  "name": "Meet & Greet service",
                  "description": null,
                  "type": "GENERAL_INFO"
                },
                {
                  "id": "BAHB",
                  "name": "1 item of hand baggage allowed per person",
                  "description": null,
                  "type": "GENERAL_INFO"
                },
                {
                  "id": "BA",
                  "name": "1 piece of baggage allowed per person ( max.dimensions 158cm) length+width+height=158cm",
                  "description": null,
                  "type": "GENERAL_INFO"
                },
                {
                  "id": "VOUC",
                  "name": "VOUCHER ",
                  "description": "Remember to bring a printed copy of this voucher and a valid photo ID with you.",
                  "type": "GENERIC_GUIDELINES"
                },
                {
                  "id": "DRVR",
                  "name": "CAN'T FIND DRIVER",
                  "description": "In the event of being unable to locate the driver, please call the emergency number indicated in this voucher.",
                  "type": "GENERIC_GUIDELINES"
                },
                {
                  "id": "MGEN",
                  "name": "Meet and Greet in English",
                  "description": "Meet and Greet in English",
                  "type": "GENERIC_GUIDELINES"
                },
                {
                  "id": "CBBS",
                  "name": "CHILDBOOSTER / BABY SEAT",
                  "description": "Child car seats and boosters are not included unless specified in your booking and can carry an extra cost. Should you need to book them, please contact your point of sale prior to travelling.",
                  "type": "GENERIC_GUIDELINES"
                },
                {
                  "id": "PLEGACHAIR",
                  "name": "Foldable wheelchairs",
                  "description": "Adapted vehicles are suitable for foldable wheelchairs. If the wheelchair cannot be folded, an extra cost may be applicable for customers",
                  "type": "GENERIC_GUIDELINES"
                }
              ],
              "customerTransferTimeInfo": [
                {
                  "value": 0,
                  "type": "CUSTOMER_MAX_WAITING_TIME",
                  "metric": "minutes"
                }
              ],
              "supplierTransferTimeInfo": [
                {
                  "value": 15,
                  "type": "SUPPLIER_MAX_WAITING_TIME_DOMESTIC",
                  "metric": "minutes"
                }
              ],
              "transferRemarks": [
                {
                  "type": "CONTRACT",
                  "description": "Pick-up point:\nYou will be picked up at the hotel reception. If you are unable to locate the driver/agent, please call KOI TECHNOLOGIES on +971 567562977 (WhatApp available), +971 45754333. Please do not leave the pick-up area without having contacted the agent/driver first. If the supplier doesn't answer the phone, please call our emergency telephone number listed at the bottom of the voucher before leaving the pick-up area.\n\nTransfer information:\n\n* Maximum client waiting time 0 minutes\n* Maximum waiting time for drivers in domestic arrivals 15 minutes\n\n* Remember to bring a printed copy of this voucher and a valid photo ID with you.\n* In the event of being unable to locate the driver, please call the emergency number indicated in this voucher.\n* Meet and Greet in English\n* Child car seats and boosters are not included unless specified in your booking and can carry an extra cost. Should you need to book them, please contact your point of sale prior to travelling.\n* Adapted vehicles are suitable for foldable wheelchairs. If the wheelchair cannot be folded, an extra cost may be applicable for customers\n\n* Exclusive ride for you:  \n* Door to door service:  \n* Meet & Greet service:  \n* 1 item of hand baggage allowed per person:  \n* 1 piece of baggage allowed per person ( max.dimensions 158cm) length+width+height=158cm:  \n\n",
                  "mandatory": true
                }
              ]
            },
            "price": {
              "totalAmount": 10632.15,
              "netAmount": 10632.15,
              "currencyId": "INR"
            },
            "cancellationPolicies": [
              {
                "amount": 10632.15,
                "from": "2023-08-10T00:00:00",
                "currencyId": "INR",
                "isForceMajeure": false
              }
            ],
            "factsheetId": 1391,
            "arrivalFlightNumber": null,
            "departureFlightNumber": "SPIJ45",
            "arrivalShipName": null,
            "departureShipName": null,
            "arrivalTrainInfo": null,
            "departureTrainInfo": null,
            "transferDetails": [
              {
                "type": "FLIGHT",
                "direction": "DEPARTURE",
                "code": "SPIJ45",
                "companyName": null
              }
            ],
            "sourceMarketEmergencyNumber": "+34871180153",
            "links": [
              {
                "rel": "transferCancel",
                "method": "DELETE"
              }
            ]
          }
        ],
        "clientReference": "5F816749F3A14",
        "remark": "",
        "totalAmount": 10632.15,
        "totalNetAmount": 10632.15,
        "pendingAmount": 10632.15,
        "currency": "INR",
        
      }
    ]
  }
}