--- updatedAt: 2026-09-22T12:10:20.000Z agentTools: projectIndex: https://open-api-docs.guesty.com/llms.txt --- # GuestyPay Tokenization Flow How to safely tokenize credit card details for the GuestyPay payment method. ## Overview There are two primary steps to creating a guest payment method through GuestyPay for reservations. 1. Collect and tokenize the guest's credit card. 2. Create the guest payment method.
Create a Guest Payment Method Sequence Diagram

Create a Guest Payment Method Sequence Diagram

## 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. * GitHub Wiki * NPM package 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 1. **Enable automation**: Include the `reservationId` when creating a payment method for payment automations availability. 2. **Reuse payment method**: Set `reuse` to `true` to allow the guest's payment method for multiple reservations.
## Troubleshooting 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.

The reservation object payload will show the payment object, nested under the money.payments section. 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. Currently, GuestyPay is only available as a live environment. You will need a valid real credit card to test payments.