1 Business Context

This guide describes the best practices to conduct authorizations and settlements with the credit card payment method for reservations.

Note:

API usage and capabilities are subject to change. For more information on API versioning, see the Versioning topic in the Oracle Hospitality Integration Platform User Guide.

For the most comprehensive and up-to-date information, including additional query parameters and detailed descriptions, always refer to the latest API specifications in GitHub. This will ensure that you are accessing the most current and complete set of features available.

Many hotels with OPERA Cloud are using the Oracle Payment Interface (OPI) to integrate with Payment Service Providers (PSP) to obtain tokens for the credit card number, and then process authorizations and payments to collect revenue. A credit card authorization is used by the hotel to verify a guest has enough funds to cover the amount to be paid on a settlement (the cost of the reservation stay). It is important to know how best to conduct successful credit card authorization and settlement transactions with the Property APIs.

Use Case Description Operation IDs
Conducting a credit card payment method authorization transaction Reservation requires a credit card pre-authorization for check-in. Pre-authorization can be taken days ahead of the guest arrival date or at the time of check-in. The reservation has an existing credit card payment method (tokenized) that the guest wants to use for the reservation authorization, or the guest has a different credit card for use and is near the credit card reader device (such as a Kiosk with a card reader attached). The Partner requests the credit card authorization accordingly and the transaction is sent to the Payment Service Provider (through OPI). The response (success or failure) is returned to the Partner.

getReservation

getPaymentMethods

getConfiguredExternalDevices

postAuthorizeCreditCardAmount

Conducting a credit card payment method settlement (payment) transaction The guest is looking to settle their reservation folio during their stay or at checkout. The reservation has an existing credit card payment method (tokenized) that the guest wants to use for a credit card settlement, or the guest has a different credit card for use and is near the credit card reader device (like a Kiosk with a card reader attached). The Partner requests the credit card settlement for the amount accordingly and the transaction is sent to the Payment Service Provider (through OPI). The response (success or failure) is returned to the Partner.

getReservation

getFolios

getConfiguredExternalDevices

postBillingPayments

Figure 1-1 Scenario 1: Credit Card Authorization with Reservation's Existing Credit Card Payment Method


This image shows scenario 1 for credit card authorization with a reservation's existing credit card payment method.

Figure 1-2 Scenario 2: Credit Card Authorization with a New Credit Card Payment Method Captured on Credit Card Reader Device


This image shows scenario 2 for credit card authorization with a new credit card payment method captured on the credit card reader device.

Figure 1-3 Scenario 3: Credit Card Settlement with Reservation's Existing Credit Card Payment Method


This image shows the scenario 3 for credit card settlement with a reservation's existing credit card payment method.

Figure 1-4 Scenario 4: Credit Card Settlement with a New Credit Card Payment Method Captured on Credit Card Reader Device


This image shows scenario 4 for credit card settlement with a new credit card payment method captured on the credit card reader device.