The Failed payment status manager agent helps you manage reservations where a payment attempt has failed. It finds reservations with a "Reserved" or "Awaiting payment" status and, by default, moves them to "Inquiry". This opens up your calendar for other guests while keeping the original reservation available. The agent then alerts you so you can contact the guest to resolve the payment issue.
This agent is designed for bookings from channels where the reservation is created in Guesty before the payment clears. You can configure the agent to either move the reservation to Inquiry or only alert you and leave the reservation status as it is.
Limitations
Review the following limitations before using the Failed payment status manager agent:
- Channels: The agent skips reservations from Airbnb, Booking.com, Expedia, and Vrbo.
- Reservations without a payment attempt: A reservation created with no card, or with no charge attempt at all, isn't considered a failed payment. It stays "Reserved" and keeps blocking the calendar.
- Functionality: The agent doesn't retry the payment or contact the guest.
Understand the Failed payment status manager agent
The Failed payment status manager agent finds reservations with a "Reserved" or "Awaiting payment" status where the most recent payment attempt has failed.
The agent runs at the following times:
- When a payment fails on a reservation. This run checks only that reservation.
- Once a day at 07:00 (based on your account's time zone) to check all relevant reservations.
- The agent can also be triggered manually.
During each run, the agent does the following:
- Scans for reservations with a "Reserved" or "Awaiting payment" status, excluding those from Airbnb, Booking.com, Expedia, and Vrbo. It never scans "Confirmed" reservations.
- For each reservation, it checks the most recent payment attempt. A failed authorization hold or security deposit doesn't count as a failed payment, so the agent ignores them.
- If that attempt failed, the agent handles the reservation as follows:
- If the card needs the guest to approve the charge (3D Secure), it leaves the reservation as it is, so a person can decide.
- If money was already collected on the reservation, it leaves the reservation as it is. For example, a reservation with a deposit paid and a late balance isn't moved.
- If the "When a payment fails" setting is Only alert me, leave the status, it leaves the reservation as it is and flags it.
- If the reservation owes more than the amount limit, it leaves the reservation as it is and flags it.
- Otherwise, it moves the reservation to Inquiry, and the dates open up.
Configure the agent's settings
By default, the agent moves a reservation to "Inquiry" and the dates open right after the failed charge, with no waiting period. To avoid this, set "When a payment fails" to Only alert me, leave the status, or set an amount limit.
The settings never override the agent's safeguards. The agent never moves a reservation from an excluded channel, with money already collected, with a card that needs guest approval, or that is no longer "Reserved" or "Awaiting payment".
Step by step:
- Sign in to your Guesty account.
- In the side navigation menu, select
AI hub. - At the top, select the Reservations tab.
- Click the Failed payment status manager tile.
- In the right-side panel, set up the agent's preferences:
-
When a payment fails: Choose what the agent should do when it finds a failed payment.
- Move to Inquiry and open the dates: (Default) The agent changes the reservation's status to "Inquiry", which makes the dates available on your calendar again.
- Only alert me, leave the status: The agent leaves the reservation status as "Reserved" or "Awaiting payment" and flags it in the run report for your review.
-
Amount limit for moving: Reservations that owe more than this amount are left as they are and flagged. The agent compares the reservation's balance due, in the reservation's own currency, to this number.
- Enter 0 (the default) for no limit.
- If a reservation's balance due is higher than the limit you set, the agent will leave it as-is and flag it in the report. If the balance due amount is unknown, the agent treats it as being over the limit.
-
When a payment fails: Choose what the agent should do when it finds a failed payment.
- Click Save.
Run the Failed payment status manager manually
In addition to the automatic runs, you can run the agent at any time from the AI hub.
Step by step:
- Sign in to your Guesty account.
- In the side navigation menu, select
AI hub. - At the top, select the Reservations tab.
- Click the Failed payment status manager tile.
- Under "When it runs", click Run now.
Review the results and status of the run in the activity feed.
Review the activity feed
Follow the steps below to review a detailed report of the agent's activity.
Step by step:
- Sign in to your Guesty account.
- In the side navigation menu, select
AI hub. - In the left submenu, click Agent activity.
- Click the relevant row with the agent's name to review the report details in the right-side panel.
Understand the report status and details
After each run, you can find the report in your activity feed. The report will have one of the following statuses:
- "Done": The agent successfully ran and completed its configured action for all relevant reservations.
- "Action needed": The agent was unable to automatically process one or more reservations. The report will list the reservations that require manual attention.
The report provides the following information for each reservation the agent processed:
- A link to the reservation.
- The action taken by the agent (e.g., "Moved to Inquiry" or "Left as is").
- The reason the original payment failed, such as "card declined".
Review and act on flagged reservations
The agent raises a high-priority alert in the following cases:
- When it moves a reservation to "Inquiry".
- When a run triggered by a failed payment leaves a reservation as it is.
When you get an alert, contact the guest to resolve the payment issue.
The daily check doesn't raise a new alert for reservations; it leaves them as they are. It lists them in the run report instead, so the same failed payment doesn't trigger an alert every day. Review the report to see which reservations the agent didn't move and decide on the next steps.