mts-booking-library 3.2.0 → 3.3.0

package/lib/booking/booking.d.ts

@@ -78,13 +78,11 @@ export declare abstract class Booking {
     /**
      * @description This method shall be used to get all necessary informations to initialize a payment with a certain gateway.
      * @param gatewayId The id of the gateway to use. Its value shall be taken from the response of the {@link Booking.getSellerGateways} API
-     * @param returnOrigin The FE origin (scheme+host+port, e.g. `window.location.origin`) that the gateway should redirect
-     * back to after the payment. The BE validates this against a per-app allowlist and stitches the canonical
-     * `/booking?step=BOOKING_STEP_PAYMENT_PROCESSING&cartGuid={guid}` path on top. Pass `window.location.origin` from the
-     * caller — the BE owns the rest. Replaces the legacy full-URL `returnUrl` parameter (BE 3.2.0+).
+     * @param returnUrl The url to which the user will be redirected after the payment. This value shall be set only if the
+     * chosen gateway is {@link GatewayTypes.PAYPAL} or {@link GatewayTypes.WORLDLINE}
      * @returns An {@link ErrorResponse} object in case of error, a {@link GetPaymentInformationFromGatewayResponse} object otherwise.
      */
-    getPaymentInformationFromGateway(gatewayId: number, returnOrigin: string, options?: ApiCallOptions): Promise<ErrorResponse | GetPaymentInformationFromGatewayResponse>;
+    getPaymentInformationFromGateway(gatewayId: number, returnUrl?: string, options?: ApiCallOptions): Promise<ErrorResponse | GetPaymentInformationFromGatewayResponse>;
     /**
      * @description This method shall be used to issue the tickets. It must be called after the payment was successful.
      * @param paymentMethod The payment method used to pay the cart. If the chosen method is {@link PaymentMethods.ZERO_COST},

package/lib/booking/booking.js

@@ -285,13 +285,11 @@ var Booking = /** @class */ (function () {
     /**
      * @description This method shall be used to get all necessary informations to initialize a payment with a certain gateway.
      * @param gatewayId The id of the gateway to use. Its value shall be taken from the response of the {@link Booking.getSellerGateways} API
-     * @param returnOrigin The FE origin (scheme+host+port, e.g. `window.location.origin`) that the gateway should redirect
-     * back to after the payment. The BE validates this against a per-app allowlist and stitches the canonical
-     * `/booking?step=BOOKING_STEP_PAYMENT_PROCESSING&cartGuid={guid}` path on top. Pass `window.location.origin` from the
-     * caller — the BE owns the rest. Replaces the legacy full-URL `returnUrl` parameter (BE 3.2.0+).
+     * @param returnUrl The url to which the user will be redirected after the payment. This value shall be set only if the
+     * chosen gateway is {@link GatewayTypes.PAYPAL} or {@link GatewayTypes.WORLDLINE}
      * @returns An {@link ErrorResponse} object in case of error, a {@link GetPaymentInformationFromGatewayResponse} object otherwise.
      */
-    Booking.prototype.getPaymentInformationFromGateway = function (gatewayId, returnOrigin, options) {
+    Booking.prototype.getPaymentInformationFromGateway = function (gatewayId, returnUrl, options) {
         return __awaiter(this, void 0, void 0, function () {
             var issueStep, searchParams, url;
             return __generator(this, function (_a) {
@@ -303,7 +301,7 @@ var Booking = /** @class */ (function () {
                 if (!issueStep || !issueStep[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                searchParams = new URLSearchParams(__assign({ gatewayId: gatewayId.toString(), cartGuid: this.cartGuid }, (returnOrigin && { returnOrigin: returnOrigin })));
+                searchParams = new URLSearchParams(__assign({ gatewayId: gatewayId.toString(), cartGuid: this.cartGuid }, (returnUrl && { returnUrl: returnUrl })));
                 url = "".concat(this.config.API_ENDPOINT, "/v3_payment/paymentInformation?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url, options).then(function (response) {
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response)

package/lib/types/common/Person.d.ts

@@ -19,6 +19,8 @@ export type Person = {
     notes?: string;
     /** The social security number of the person. */
     socialSecurityNumber?: string | null;
+    /** The sex of the person. M = male, F = female, O = other. */
+    sex?: "M" | "F" | "O" | null;
 };
 export declare const DEFAULT_PERSON: Person;
 export declare const initializePerson: (person?: Person | undefined | null) => Person;
@@ -55,6 +57,8 @@ export type GetPassenger = Person & {
     passengerPhoneNumberOption: PersonDataFieldStatus;
     /** Whether the passenger social security number is reuqired, optional or cannot be specified. */
     passengerSSNOption: PersonDataFieldStatus;
+    /** Whether the passenger sex is required, optional or cannot be specified. */
+    passengerSexOption?: PersonDataFieldStatus;
 };
 export declare enum PersonDataFieldStatus {
     /** The field (e.g. the buyer's email) is optional. The input shall be displayed, but the user can skip it. */

package/lib/types/common/Person.js

@@ -8,7 +8,8 @@ exports.DEFAULT_PERSON = {
     lastName: "",
     email: "",
     phoneNumber: "",
-    socialSecurityNumber: null
+    socialSecurityNumber: null,
+    sex: undefined
 };
 var initializePerson = function (person) {
     if (!person) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mts-booking-library",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Library for using MyTicketSolution Booking API",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",