Skip to content
English
More support
Go to Bookvault
  • There are no suggestions because the search field is empty.

Troubleshooting Your Bookvault Payhip Integration

Having trouble with your Bookvault Payhip integration? Check your installation, product setup, webhook and SKUs to make sure orders can reach Bookvault correctly.

If you've connected Payhip to Bookvault but your orders aren't appearing correctly, work through the checks below.

1. Check you only have one Payhip installation

In your Bookvault account:

  1. Go to Apps.
  2. Check the dropdown showing your connected Payhip installations.
  3. Make sure there is only one active Payhip connection.

If more than one Payhip connection appears, contact our support team so the duplicate connection can be removed.

2. Check your products are set up in Bookvault

Each book you want to sell through Payhip needs to be correctly configured.

In Bookvault:

  1. Find the ISBN or product listing you want to sell.
  2. Click the cart icon on the right.
  3. Select Add a Product.
  4. Complete the required information.
  5. Select the print facilities that can manufacture your book.

If you're setting the title up for pre-sale, you can also enter the appropriate pre-sale information during this process.

3. Check your Payhip webhook

A webhook is required so Bookvault can receive order information from Payhip.

In Payhip, go to:

Account Settings → Developer

Check that a webhook is listed.

If you can't see one or aren't sure whether the webhook is correct, contact our support team so we can confirm or provide your webhook URL.

4. Check your SKUs match

The SKU in Payhip must exactly match the SKU used for the product in Bookvault.

Your Bookvault SKU will be either:

  • the ISBN you've entered for the book
  • the 13-digit dummy ISBN generated by Bookvault

Enter this same SKU in the corresponding product settings in Payhip.

Make sure the SKU hasn't been entered with additional characters, spaces or dashes. Even a small difference can prevent Bookvault from correctly matching the Payhip product to your title.

What happens to orders placed before I fixed the connection?

Fixing your Payhip connection doesn't necessarily cause earlier orders to be sent to Bookvault retrospectively.

If an order was placed while the integration or SKU was incorrect and it hasn't appeared in Bookvault after the connection has been fixed, you may need to place that order manually through the Bookvault portal.

If you're unsure whether an order has reached Bookvault, contact Support with your Payhip order ID and product SKU.

 

My Payhip orders still aren't appearing in Bookvault

If you've checked everything above and your orders still aren't coming through, contact:

customers@bookvault.app

Please include:

  • The SKU of the affected product
  • Your Payhip order ID

Our team can then investigate the order and connection for you.