--- title: "Cancel hotel pnr" method: POST path: "/v2/hotel/pnrs/{pnrId}/cancel-pnr" tags: ["Hotel"] --- # Cancel hotel pnr `POST /v2/hotel/pnrs/{pnrId}/cancel-pnr` This endpoint deletes a pnr by pnrID. ## Request body - HotelCancelPnrRequest — Request object for cancelling a hotel pnr. - `customFieldV3Responses` CustomFieldV3Response[] — Custom field responses for the booking. - `fieldId` string, uuid, required — Custom field id - `fieldName` string — Name of the custom field - `armId` string, uuid, required — Arm id which is applicable - `includeLocations` IncludeLocation[] - `selectedOptions` CustomFieldSelectedOption[], required — The list of options that are selected by user or auto populated. - `name` string, required — Value of the selection - `translatedName` string — Translated value of the selection - `description` string — Description of the selection - `translatedDescription` string — Translated description of the selection - `additionalUserInput` string — Additional user input - `additionalInfos` string[] — Actual values of the additional infos - `additionalInfoConfigs` AdditionalInfo[] — Additional info configs for the selected option - union — Additional data need to be sent along with the custom field response. - object — Variable defining the additional value to be sent along with custom field response. - `type` string, required - `name` 'PUBLISHED_FARE' | 'LLF' | 'ADD_COLLECT_AMOUNT' | 'SELECTED_FARE' | 'SPLIT_PAYMENT_FARE', required — Name of the variable. - object — Expression consisting of variables and constants which needs to be sent along with custom field response. - `type` string, required - `formatExpression` string, required — The expression must be of format : ` ${expression} `.The expression can consist of a combination of variables and mathematical operations. Variable names must be same as VariableName Enum. To define mathematical operations, the operation name should follow the format `math.(arg1, arg2)`. Both `arg1` and `arg2` can be variables or constants. The supported math operations (math_op) include: `add, mul, div, sub, min, and max`. All keywords, such as `, math, and var` must be written in lowercase. - `variables` VariableName[] — Reference names of the variables present in the expression. - `postPaymentVerificationInfo` union — Payment information sent after the verification of payment method. - object — Wrapper for post stripe verification info object. - `postStripeVerificationInfo` PostStripeVerificationInfo — Object to indicate successful stripe verification and provide payment information for next steps. - `paymentMethodId` string — Stripe's payment method id for which the verification was performed. - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification. - object — Wrapper for post url based verification info object. - `postUrlBasedVerificationInfo` PostUrlBasedVerificationInfo - `pnrId` string — Pnr Id, to continue with the booking flow/check the status of the pnr. - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification. - object — Wrapper for amadeus checkout verification info object - `amadeusCheckoutVerificationInfo` AmadeusCheckoutVerificationInfo - `paymentActionTokens` AmadeusPaymentActionToken[], required - `paymentRequestId` string, required — Initial payment id generated by checkout SDK to initiate payment - `actionToken` string, required — Token returned by checkout SDK to create/validate FOP in PSS order - `paymentRequestId` string — Initial payment id generated by checkout SDK to initiate payment - `actionToken` string — Token returned by checkout SDK to create/validate FOP in PSS order - `confirmPayment` boolean — Flag which indicates that the payment confirmation is now required (after 3ds or redirection) - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification. - object — Wrapper for 3DS2 post verification info object - `threeDSecure2PostVerificationInfo` ThreeDSecure2PostVerificationInfo — Result of 3DS2 verification. - `results` ThreeDSecure2VerificationResultItem[], required — List of 3DS2 verification results. - `cardId` string, required — Card id for which the verification was performed. - `sessionId` string, required — session id of the payment service provider. - `success` boolean, required — Whether the 3DSecure2 authentication was successful. - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification. - object — Wrapper for post razorpay verification info object. - `postRazorpayVerificationInfo` RazorpayPostVerificationInfo — Object to indicate successful stripe verification and provide payment information for next steps. - `paymentId` string, required — Razorpay payment id for which the verification was performed. - `orderId` string — Razorpay order id in which the payment was added. - `signature` string — Razorpay signature to validate the payment. - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification. - `bookingPaymentDetails` BookingPaymentDetails — Payment details used for booking. - `bookingTravelerPaymentDetails` BookingTravelerPaymentDetails[], required - `selectedFormOfPayments` SelectedFormOfPayment[], required - `paymentItems` PaymentItem[], required - `itemType` 'SERVICE_FEE' | 'TRAVEL_TICKET' | 'SEAT' | 'BAGGAGE' | 'EARLY_BIRD' — Type of payment item eligible for this fop rule - `fareComponent` FareComponent[] - `selectedPaymentSources` SelectedPaymentSource[], required - `paymentSourceId` string, uuid — Unique identifier identifying this payment source. - `rawPaymentSource` union — Raw Details of the Payment Source - object — Object to pass through dpan payment source details through the api call. - … - object - … - `postPaymentRedirectionUrl` string — Url for post payment redirection if payment source navigates user to a third party url - `cvv` string — CVV associated with associated payment source, if any. - `amount` Money — Money object containing details such as the amount, the currency code, and the converted amount. - `amount` number, double, required — The numeric value for the amount of money. - `currencyCode` string, required — The 3-letter currency code for the money amount (defined using ISO 4217 standard). - `convertedAmount` number, double — The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency). - `convertedCurrency` string — The 3-letter currency code for the converted currency (defined using ISO 4217 standard). - `otherCoinage` object[] — List of the dollar amount in other coinage systems like reward points, cryptocurrency etc. - … ## Response `200` OK - HotelCancelPnrResponse — Response object for cancelling a hotel pnr. - `confirmationId` string, required — The confirmation ID of the cancelled hotel pnr. - `paymentVerificationInfo` union — VerificationInfo required for the payment operation. - object — Wrapper for stripe verification Info. - `stripeVerificationInfo` StripeVerificationInfo — Verification information required for card stripe verification. - `stripeCardTokens` StripeCardTokens — Stripe card tokens used by clients in authorizing newly added cards. - `paymentProcessor` string, required — Payment processor involved. - `paymentMethodId` string, required — Stripe's payment-method-id for the card. - `setupIntentClientSecret` string, required — Stripe client secret for attaching the card to the setup-intent. - `connectedAccountId` string — Account Id of the connected account in which above payment-method and setup-intent exist. This is populated only when a connected account is used. - `publishableKey` string — Publishable key of the Stripe platform account. - `gatewayIdentifier` GatewayIdentifier - `gatewayId` string — Gateway Id for which the payment method should be verified. - `gatewayType` 'PAYMENT_GATEWAY_UNKNOWN' | 'STRIPE' | 'BREX' | 'RAZORPAY' — Gateway Type for of the verification gateway. - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification. - object — Wrapper for stripe verification Info. - `urlVerificationInfo` UrlVerificationInfo — Verification information required for url based payment verification. - `ccVerificationUrl` string — Verification url for the payment source. - `gatewayIdentifier` GatewayIdentifier - `gatewayId` string — Gateway Id for which the payment method should be verified. - `gatewayType` 'PAYMENT_GATEWAY_UNKNOWN' | 'STRIPE' | 'BREX' | 'RAZORPAY' — Gateway Type for of the verification gateway. - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification. - object — Wrapper for 3DS2 verification Info. - `threeDSecure2VerificationInfo` ThreeDSecure2VerificationInfo — Verification information required for 3DS2 authentication. - `verificationInfoList` ThreeDSecure2VerificationInfoItem[], required — List of 3DS2 verification info. - `cardId` string, required — Card id for which the verification was performed. - `sessionId` string, required — session id of the payment service provider. - `redirectUrl` string, required — 3DS2 verification redirect url. - `gatewayIdentifier` GatewayIdentifier - `gatewayId` string — Gateway Id for which the payment method should be verified. - `gatewayType` 'PAYMENT_GATEWAY_UNKNOWN' | 'STRIPE' | 'BREX' | 'RAZORPAY' — Gateway Type for of the verification gateway. - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification. - object — Wrapper for Razorpay verification Info. - `razorPayVerificationInfo` RazorpayVerificationInfo — Verification information required when card is tokenized via Razorpay for Indian markets. - `paymentProcessor` string, required — Payment processor involved. - `paymentAuthUrl` string — URL for authorizing the payment on the card. - `gatewayIdentifier` GatewayIdentifier - `gatewayId` string — Gateway Id for which the payment method should be verified. - `gatewayType` 'PAYMENT_GATEWAY_UNKNOWN' | 'STRIPE' | 'BREX' | 'RAZORPAY' — Gateway Type for of the verification gateway. - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification. ## Other responses - `401` — Unauthorized - `403` — Forbidden - `404` — The specified resource was not found. --- [API](https://skmtc.net/spotnana/apis/hotel-api.md) · [All operations](https://skmtc.net/spotnana/apis/hotel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotnana/hotel-api/revisions/4ad6bc6046c1/schema)