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
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 :
If you're having trouble figuring out if your signature is correct, this calculator should help.
Visit our forums to connect with the community and find out more about the Shopify API and App development.
The Hosted Payment Simulator will allow you to simulate the redirects and callbacks needed to build an integration