How to get OrderID on offsite payment portal?

Technical Q&A

Topic summary

Main issue: In an offsite payment flow for a Shopify app, developers need the Order ID to confirm payment and redirect customers back, but the payment session payload provides only a request_id, not the Order ID.

What’s proposed: Pass a unique identifier (ideally the Order ID) to the offsite portal via the redirect URL and include it on the return URL to map the payment back to the correct order. Then use that identifier to update order status upon return.

Blocking problem: The original poster notes Shopify’s payment session only includes a request_id, so they cannot obtain the Order ID from session details. They ask how to derive or fetch the Order ID from that request.

Additional input: Another developer suggests a GraphQL call to obtain the redirect URL after payment but lacks the required mutation/permissions and asks which scopes are needed. Docs cited: offsite payment request reference and payment processing.

Status: Unresolved. Open questions: mapping request_id to Order ID; required GraphQL mutation and permissions.

Summarized with AI on December 22. AI used: gpt-5.
1

Hi

I have redirect the customer on offsite payment portal but conforming the payment how to redierct customer back. I have not Order ID to confirm the order status.

How to get order ID on offsite payment portal?

Thanks

2

Hi Anilket,

Thank you for reaching out with your question about integrating an offsite payment portal and retrieving the order ID.

To ensure a seamless redirection back to your Shopify store after payment confirmation on the offsite portal, you typically need to pass information back and forth between your store and the payment portal. Here’s how you can approach it:

  1. Order ID Generation:

    • When redirecting customers to the offsite payment portal, you should include unique identifiers such as the order ID or transaction ID as part of the redirect URL parameters. This identifier helps link the payment confirmation back to the specific order in your Shopify store.

  2. Passing Order Information:

    • Before redirecting to the payment portal, gather necessary order details (like order ID, customer details, and payment amount) and include them in the redirect URL query string. For example, your redirect URL might look like: https://paymentportal.com/redirect?order_id=123456.

  3. Handling Redirect Back to Shopify:

    • After the customer completes payment on the offsite portal, the portal should redirect back to a specific URL on your Shopify store. This return URL should include parameters that allow you to retrieve the order ID and update the order status accordingly.

  4. Updating Order Status:

    • Once redirected back to your Shopify store, extract the order ID from the URL parameters and use it to update the order status based on the payment confirmation received from the offsite portal.

If you need further assistance with implementing this process or have specific technical questions, please let me know. I’m here to help!

3

Hi @polo_msweb
Thanks for reply.
I have checked the solution you provided. But issue is that when shopify send payment session details it send only request ID not the Order ID. So how I will get the order ID from the payment session details that shopify send to the payment app.

Kindly guide me how to get the Order ID from Shopify payment session details?

I have followed this doc:

https://shopify.dev/docs/apps/build/payments/request-reference#offsite-payment

Thanks

4

I have the same problem as you, from what I’ve been investigating, you have to make a call to graphql to get the redirect url, after making the payment, in my case I don’t have said mutation, I don’t have the permissions apparently, but I don’t know what they are either, if you can help me with this I would appreciate it, here is the link to the above commented
https://shopify.dev/docs/apps/build/payments/processing