Pay At Property Rates

Overview

This guide explains how to identify and support the implementation of Pay at Property rate plans.

Pay at Property bookings allow guests to confirm a reservation without charging their card at the time of booking, and the property collects payment directly from the guest, typically at check-in or check-out. Some Pay at Property rates may even allow guests to confirm bookings without credit card details.
Pay at Property rates offer guests greater flexibility at the time of booking, which can be appealing to the end customers.

Activate Pay at Property rates

Contact your manager to activate Pay at Property rates for your account before implementation.

Implement Pay at Property rates in Availability

Identify Pay at Property rate flag

You can use the following fields to identify if a rate allows pay at property option.

Field in Search 2.0 API	Description
`payment.model`	Only the Agency rates can be Pay at Property rates. You can identify Pay at Property rates with the `payment.model=AGENCY` value.
`payment.isPayAtProperty`	This boolean flag will return `true` for Pay at Property rates.

Charge amounts in property currency

For pay at property rates, ensure that you display the charge amounts in the property currency to the customer.

Field in Search 2.0 API	Description
`currencies.property`	This is the currency in which the customer will be charged. We recommend that you clearly convey the `property` currency and the charge amounts in this currency to the customer at checkout.

Identify if credit card details are required to confirm booking

Pay at Property rates may still require the credit card details to confirm the reservation.

Field in Search 2.0 API	Description
`payment.isBookWithoutCreditCard`	If `isBookWithoutCreditCard=false`, the customer card details are required to confirm the reservation. Note that the card will not be charged at booking. If `bookWithoutCreditCard=true`, you do not need to collect the customer's card details.

Example of Search 2.0 Availability response for Pay at Property rate

{
    "meta": {
        "status": "SUCCESS"
    },
    "data": {
        "searchId": 5182691593281754041,
        "properties": [
            {
                "id": 4877,
                "currencies": {
                    "display": [
                        "CAD"
                    ],
                    "booking": "USD",
                    "property": "INR"
                },
                "rooms": [
                    {
                        "id": 4883563,
                        "parentId": 3203499,
                        "offers": [
                            {
                                "id": "v1_CgEt...",
                                "payment": {
                                    "model": "AGENCY",
                                    "isPayAtProperty": true,
                                    "isBookWithoutCreditCard": false
                                },
                                "pricing": {
                                    "bookingRates": [
                                        {
                                            "currency": "USD",
                                            "price": {
                                                "inclusiveAmount": 661.60,
                                                "exclusiveAmount": 560.68,
                                                "tax": {},
                                                "fees": {}
                                            }
                                        },
                                        {
                                            "currency": "CAD",
                                            "price": {
                                                "inclusiveAmount": 942.20,
                                                "exclusiveAmount": 798.46,
                                                "tax": {},
                                                "fees": {}
                                            }
                                        },
                                        {
                                            "currency": "INR",
                                            "price": {
                                                "inclusiveAmount": 63720.00,
                                                "exclusiveAmount": 54000.00,
                                                "tax": {
                                                    "amount": 9720.00,
                                                    "breakdown": [
                                                        {
                                                            "id": 80,
                                                            "amount": 9720.00,
                                                            "percent": 0.0,
                                                            "isBase": false,
                                                            "isTaxable": false
                                                        }
                                                    ]
                                                },
                                                "fees": {
                                                    "amount": 0.00,
                                                    "breakdown": [
                                                        {
                                                            "id": 2,
                                                            "amount": 0,
                                                            "percent": 0,
                                                            "isBase": false,
                                                            "isTaxable": false
                                                        }
                                                    ]
                                                },
                                                "strikeThroughRate": {
                                                    "inclusiveAmount": 63720.00,
                                                    "savingAmount": 0.00
                                                },
                                                "minSellRate": {
                                                    "inclusiveAmount": 63720.00
                                                }
                                            },
                                            "surcharge": {
                                                "included": []
                                            }
                                        }
                                    ],
                                    "display": {
                                        "sellAllInRates": [
                                            {
                                                "currency": "USD",
                                                "price": {
                                                    "inclusiveAmount": 661.60,
                                                    "exclusiveAmount": 560.68,
                                                    "tax": {},
                                                    "fees": {}
                                                }
                                            },
                                            {
                                                "currency": "CAD",
                                                "price": {
                                                    "inclusiveAmount": 942.20,
                                                    "exclusiveAmount": 798.46,
                                                    "tax": {},
                                                    "fees": {}
                                                }
                                            },
                                            {
                                                "currency": "INR",
                                                "price": {
                                                    "inclusiveAmount": 63720.00,
                                                    "exclusiveAmount": 54000.00,
                                                    "tax": {
                                                        "amount": 9720.00,
                                                        "breakdown": [
                                                            {
                                                                "id": 80,
                                                                "amount": 9720.00,
                                                                "percent": 0.0,
                                                                "isBase": false,
                                                                "isTaxable": false
                                                            }
                                                        ]
                                                    },
                                                    "fees": {
                                                        "amount": 0.00,
                                                        "breakdown": [
                                                            {
                                                                "id": 2,
                                                                "amount": 0,
                                                                "percent": 0,
                                                                "isBase": false,
                                                                "isTaxable": false
                                                            }
                                                        ]
                                                    },
                                                    "strikeThroughRate": {
                                                        "inclusiveAmount": 63720.00,
                                                        "savingAmount": 0.00
                                                    },
                                                    "minSellRate": {
                                                        "inclusiveAmount": 63720.00
                                                    }
                                                },
                                                "surcharge": {
                                                    "included": [],
                                                    "excluded": []
                                                },
                                                "partnerPricing": {
                                                    "taxDueSupplierAmount": 0
                                                }
                                            }
                                        ]
                                    }
                                }
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

Precheck and book Pay at Property rates

You may perform Precheck and Book request for a Pay at Property rate in the same way as any other booking using the Precheck and Book APIs.