Skip to content

Confirm the reservation

This method confirms the reservation previously made in our systems.

Access method

POST /ShoppingCart/Sale

Request structure

  • ShoppingCartId: (string) Required. Cart identifier.
  • PartnerSaleId: (string) Required. Partner identifier.
  • InsurancePolicyId: (string) Optional. Refund insurance policy identifier.

    Information

    This identifier is obtained when calling check available policies. That function returns a list of available policies with their identifiers (Id). That is the identifier that must be used in this field.

  • DiscountCouponCodes: (list) Optional. List of coupon codes (discounts/promotions) issued by the venue through this platform.

    • (string): (list) Required. Coupon code.
  • Client: (object) Optional. Customer information. If the sale contains hotels, this property is mandatory. If it only contains activities, this parameter depends on the configuration agreed with the partner.
    • FullName: (string) Required. Name.
    • Surname: (string) Required. Surname.
    • DocumentIdentifier: (string) Required. Identity document.
    • PhoneNumber: (string) Required. Phone number.
    • Email: (string) Required. Email address.
  • PaymentMethod: (string) Optional. Payment method information. It only needs to be filled in when the partner has a debit contract.
    • PaymentMethodType: (int) Required. Payment method identifier.
    • ReturnUrlOk: (string) Required. URL that will be notified if the payment succeeds.
    • ReturnUrlKo: (string) Required. URL that will be notified if the payment fails.
    • SendByEmail: (boolean) Required. Indicates that we want to send the customer a payment link by email, if the option is available. See PaymentMethods.PaymentMethod.EnableSendByEmail.

Request example

Examples
{
  "ShoppingCartId": "{{ShoppingCartId}}",
  "PartnerSaleId": "{{PartnerSaleId}}",
  "DiscountCouponCodes": [],
  "Client": {
    "FullName": "Sylvanas",
    "Surname": "Windrunner",
    "DocumentIdentifier": "91039185",
    "PhoneNumber": "34123456789",
    "Email": "sylvanas@SanctumofDomination.com"
  },
  "PaymentMethod": {
    "PaymentMethodType": 1,
    "ReturnUrlOk": "https://someurl.local/ok",
    "ReturnUrlKo": "https://someurl.local/ko",
    "SendByEmail": false
  }
}

Response structure

  • PaymentRedirectUrl: (string). For partners with debit payment, this property indicates the URL where the customer must be redirected to complete the payment.
  • ExperticketSales: (list). List of associated sales.

    • ExperticketSale: (object). Sale information.
      • Id: (string). Sale identifier.
        • FinancialRatios: (object). Economic concepts of a sale.
          • ReferenceSalePrice: (object). Reference sale price.
            • BasePrice: (double). Base price
            • Quota: (double). Commission
            • Total: (double). Total
          • Discount: (object). Commercial discount.
            • BasePrice: (double). Base price
            • Quota: (double). Commission
            • Total: (double). Total
          • Commission: (object). Partner cost.
            • BasePrice: (double). Base price
            • Quota: (double). Commission
            • Total: (double). Total
          • SalePrice: (object). Sale price.
            • BasePrice: (double). Base price
            • Quota: (double). Commission
            • Total: (double). Total
  • Success: (boolean). Value that indicates whether the call was processed correctly or not.

  • Errors: (list). Array of errors.
    • Error: (object).
      • ErrorMessage: (string). Error message explaining why the request was not successful. If it was correct, it will return null.
      • ErrorCode: (int). Code that identifies the error.
  • ErrorEntityBreakDown (list): list that contains objects with the name and ID in case of error.
    • Id (string): identifier
    • Name (string): related name of the identifier.

Response example

Examples
{
    "ExperticketSales": [
        {
            "Id": "5049250640429850462"
        }
    ],
    "Success": true
}

Additional HTTP headers

  • This call accepts an additional header to indicate the partner user who is performing the sale:
Header name Header value
AdminPartnerUserId AdminPartner user identifier