GuestyPay Tokenization Flow

Overview

There are two primary steps to creating a guest payment method through GuestyPay for reservations.

Collect and tokenize the guest's credit card.
Create the guest payment method.

Create a Guest Payment Method Sequence Diagram — Figure 1.0. Create a Guest Payment Method Flow

Step 1: Tokenize the Guest's Card

📘
Determine the Payment Processor ID
The API will automatically identify a property's payment processor when you include the listingId in your tokenization request. Even then, it is a best practice to include the paymentProviderId as well. You can retrieve it with the following request.

Get payment provider by listing id

Payment Form and SDK

The quickest, easiest, and recommended way to process payments on your website is to use our payment form SDK. Guesty offers a JavaScript SDK that supports multiple payment methods, ensuring your guests enjoy a personalized and hassle-free checkout experience. It's secure and PCI-compliant. You can access it at the links below.

Please note that the SDK supports the GuestyPay, Merchant Warrior, and HYP payment processors.

❗️
Migrate to the SDK
If you previously, built a direct integration with the GuestyPay API, please migrate to the latest version of our SDK. For assistance or any questions, please contact Customer Experience.

Step 2: Create the Guest Payment Method

This action is part of the second step of the Open API's booking process. You will use the token you've generated to create the payment method. For a detailed explanation and examples, see Create a Guest and Payment Method

🚧
Payment Automation and Reusability

Enable automation: Include the reservationId when creating a payment method for payment automations availability.

Reuse payment method: Set reuse to true to allow the guest's payment method for multiple reservations.

Troubleshooting

The reservation was created without a payment method

This may be due to either of the following:

The credit card was tokenized in a different payment processor account than the one assigned to the listing. Determine the correct account using the Get payment provider by listing and Get provider stats.
The payment processor or credit card issuer reported an issue. Check your payment processor extranet for error messages and see our Help Center troubleshooting articles.

How can I be sure the payment method succeeded?

The reservation object payload will show the payment object, nested under the money.payments section.

Error 402: ERR\_BAD\_REQUEST

When the data of your response contains the messages: "Request contradicts clearing interface configuration" and"Bad Bin or Host Disconnect", it means there is an issue with your GuestyPay account and it could be offline. To remedy this, contact Customer Experience.

Does GuestyPay have a test environment?

Currently, GuestyPay is only available as a live environment. You will need a valid real credit card to test payments.