Below are some frequently asked questions from our developer community.

"422 Unprocessable Entity: Notification acknowledgment failed" when sending the response

This error occurs when an invalid x_signature parameter is being sent in the response. Either the merchant has input the incorrect credentials in the Payment settings of their store, or there is an issue with how the signature is being calculated. You can use the Signature Calculator Tool to verify that your signature calculation mechanism is working correctly.

"422 Unprocessable Entity: Unable to find checkout with id <x>"

You'll need to ensure that the x_reference value that you are providing matches the checkout ID that is generated by Shopify. This value will be the same as the x_reference value that was sent in the parameters of the request.

Is it possible to modify the Order ID on Shopify?

No, order IDs are generated sequentially by Shopify and are not mutable.

Is it possible to create an order with "pending" payment status, and then transition to "paid" at a later time? (i.e. when goods are ready to ship)

Upon sending the initial notification to x_url_callback, you can provide an x_result value of pending. To transition the order in Shopify to the "paid" status, simply send another notification to x_url_callback at a later time with an x_result value of completed.

Why am I receiving empty order management requests?

Payment requests to your integration have their parameters stored in the URL as query string parameters, but order management requests have their parameters stored within the request body instead. When your gateway processes order management requests, make sure that it reads the request body.

If you're still looking for answers :

Hosted Payments Signature Calculator

If you're having trouble figuring out if your signature is correct, this calculator should help.

Shopify API Developer Forums

Visit our forums to connect with the community and find out more about the Shopify API and App development.

Sample Hosted Payments project

The Hosted Payment Simulator will allow you to simulate the redirects and callbacks needed to build an integration

Sign up for a Partner account to get started.

Sign up