11 FAQ

Why am I receiving a 502 Gateway Timeout error in many instances where guest is interacting with the credit card reader device?

If the process takes longer than 60 seconds, the API call will be timed out. Ensure the guest is ready to present their credit card before initiating any call that is meant to activate a reader device.

Is there a way to handle it if I receive a 502 Gateway Timeout error?

You can call the following endpoint for up to 2 minutes and verify if the response has the authorizations or settlements (payments):

.../csh/v1/hotels/{{HotelId}}/reservations/{{reservationId}}/authorizationHistory?includeRefunds=false&includeFailures=false&includePayments=true&type=Reservation&includeAuthorizations=true

What if I have a credit card number the guest wants to use for an authorization or settlement, can I send that in the API requests?

No. When OPI is active with the property, no credit card numbers will be accepted in the Property APIs. See the section on Limitations and Constraints point 2 for information that can help in this scenario.

Can I submit authorization and settlement requests when OPI is not active at a property?

Yes, if it is just for informational purposes only. Review this implementation guide for other use cases.