Booking Engine Guide
  • Mews Booking Engine Guide
  • Booking Engine Standalone
    • Getting started
    • Deeplinks
  • Booking Engine Widget
    • Getting started
    • Use cases
      • Prerequisites
      • Testing in the Demo environment
      • Using your own Date inputs
      • Multiple enterprises and pre-selected locations
      • Disabling widget caching
    • Advanced guide
    • Reference
    • Troubleshooting
  • Booking Engine API
    • Usage guidelines
      • Authentication
      • Requests
      • Responses
      • Environments
      • Images
      • Supported currency codes
      • Supported language codes
    • Use cases
      • Availability blocks
      • On session payments
      • Payment card authorization
      • Supporting payment cards
    • API Operations
      • Availability blocks
      • Configuration
      • Hotels
      • Payment cards
      • Reservations
      • Reservation groups
      • Services
      • Vouchers
    • Deprecations
  • Integrations
    • Google Tag Manager
    • Google Triggers Reference
    • Google Tag Manager Configuration
    • Google Analytics cross-domain tracking
  • FAQ
    • Ways to integrate
    • Migration off the mews.li domain
  • Changelog
    • Changelog 2024
    • Changelog 2023
    • Changelog 2022
    • Changelog 2021
    • Changelog 2020
Powered by GitBook
On this page
  • Get payment cards
  • Request
  • Response
  • Authorize payment card
  • Request
  • Response

Was this helpful?

  1. Booking Engine API
  2. API Operations

Payment cards

Get payment cards

Fetch details about the listed payment cards, in particular the Authorization state.

Request

[ApiBaseUrl]/api/distributor/v1/paymentCards/getAll

{
    "Client": "My Client 1.0.0",
    "PaymentCardIds": [
        "dc2f8608-9d71-47fd-9d41-ad1a009913c6"
    ]
}
Property
Type
Contract
Description

PaymentCardIds

array of string

required

Response

{
    "PaymentCards": [
        {
            "Id": "dc2f8608-9d71-47fd-9d41-ad1a009913c6",
            "AuthorizationState": "Authorizable"
        }
    ]
}
Property
Type
Contract
Description

PaymentCards

required

The payment cards.

Payment card

Property
Type
Contract
Description

Id

string

required

Unique identifier of the payment card.

AuthorizationState

required

Authorization state of the card.

Authorization state

  • Authorized - Finite state. The payment card has been authorized.

  • Authorizable - Non-finite state. The payment card can be authorized.

  • Unauthorizable - Finite state. The payment card cannot be authorized.

Authorize payment card

Request authorization of the specified payment card.

Request

[ApiBaseUrl]/api/distributor/v1/paymentCards/authorize

{
    "Client": "My Client 1.0.0",
    "EnterpriseId": "8a51f050-8467-4e92-84d5-abc800c810b8",
    "PaymentCardId": "dc2f8608-9d71-47fd-9d41-ad1a009913c6",
    "BrowserInfo": {
        "ScreenWidth": 2560,
        "ScreenHeight": 1440,
        "ColorDepth": 24,
        "UserAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.85 Safari/537.36",
        "Language": "cs",
        "JavaEnabled": false,
        "TimeZoneOffset": -120
    }
}
Property
Type
Contract
Description

EnterpriseId

string

required

Unique identifier of the enterprise which has access to the payment card.

PaymentCardId

string

required

Unique identifier of the payment card.

BrowserInfo

required

Information about the user's browser.

Browser info

Property
Type
Contract
Description

ScreenWidth

number

required

ScreenHeight

number

required

ColorDepth

number

required

UserAgent

string

required

Language

string

required

JavaEnabled

boolean

required

TimeZoneOffset

number

required

Response

{
    "Id": "94835eb5-24e1-421f-9915-ad1a009de562",
    "PaymentCardId": "dc2f8608-9d71-47fd-9d41-ad1a009913c6",
    "State": "Authorized"
}
Property
Type
Contract
Description

Id

string

required

Unique identifier of the payment card authorization attempt.

PaymentCardId

string

required

Unique identifier of the payment card being authorized.

State

required

State of the card authorization attempt.

Authorization request state

  • Authorized - Finite state. The payment card authorization has been successfully completed.

  • Requested - Non-finite state. The payment card authorization is requested from the user.

  • Pending - Non-finite state. The payment card authorization is waiting to be requested from the user.

  • Declined - Finite state. The payment card authorization has been declined.

  • Canceled - Finite state. The payment card authorization has been canceled.

PreviousHotelsNextReservations

Last updated 2 years ago

Was this helpful?

Unique identifiers of the .

array of

string

Integer value of the .

Integer value of the .

Integer value of the .

Value of the browser .

Value of the browser .

Value of the browser information on whether . This will always be false.

Integer value of the user .

string

user screen width
user screen height
user screen color depth
user agent
language
Java is enabled
timezone offset
Payment cards
Payment cards
Authorization state
Browser info
Authorization request state