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.
- Collect and tokenize the guest's credit card.
- Pass the token in the reservation creation request.
Figure 1.0. GuestyPay Tokenization Flow
Step 1: Tokenize the Guest's Card
Determine the Payment Processor IDThe API will automatically identify a property's payment processor when you include the
listingIdin your tokenization request. Even then, it is a best practice to include thepaymentProviderIdas well. You can retrieve it with the following request.
Payment Form and SDK
The quickest, easiest, and recommended way to facilitate payments on your website is by using our payment form SDK. Guesty offers a JavaScript SDK that supports multiple payment methods, ensuring that your guests enjoy a personalized and hassle-free checkout process. 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 SDKIf 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 Reservation
Pass the GuestyPay token you've generated as the ccToken in the Create inquiry for reservation based on quote or Create instant reservation based on quote requests.
Reuse of Tokens
Using the same payment token for multiple reservations is not supported. It will result in a "missing payment method" error in the user dashboard (even though one exists), preventing payment automations from executing as scheduled. Generate a new token for each new inquiry or reservation through the Booking Engine API.
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.
Updated 9 days ago