Skip to content
Search Articles/

less than a minute read • Updated 9 minutes ago

Confirm inventory before checkout with the pre-payment webhook

How to use Foxy's pre-payment webhook to check product stock right before checkout completes, preventing overselling between cart and payment.

Use the pre-payment webhook to confirm a product’s stock is still available right before a customer completes checkout, closing the gap between when a product is added to the cart and when the order actually goes through.

How to set it up

  1. 1

    Enable the pre-payment webhook for your store. This sends a request to an endpoint of your choosing right as the customer attempts to complete checkout, with the full transaction payload — including the products in the cart, the address entered, and any custom fields.

  2. 2

    At your endpoint, check that there’s still enough stock available for the customer’s order based on your own inventory records.

  3. 3

    If stock is available, let the checkout attempt proceed. See Respond to the pre-payment webhook for how to do this.

  4. 4

    If stock isn’t available, stop the checkout and return a custom error message to the customer.

Notes

  • You can also use the Foxy API to modify the cart directly from your endpoint — for example, removing or updating products before sending the customer back to the checkout. The pre-payment webhook payload includes the URIs needed to interact with those resources.

  • This check matters most for stores with higher transaction volume, or where a customer might add a product to their cart and not complete checkout until hours or days later — giving stock levels more time to change in the meantime.

  • See the pre-payment webhook payload reference for the full list of data included in the request.

Need Help?

Did this article answer your questions? Need help with anything? Please click below to contact us.