PunchOutHub Docs

PunchOutHub Troubleshooting

Use this guide to separate setup problems, session problems, add-to-cart problems, return cart problems, and buyer-side issues. Start from the symptom and then confirm logs.

First checkWas the user inside a real PunchOut session?
Second checkDid cart add and return actions appear in logs?
Third checkDoes return URL accept the cart post?

Common symptoms

No Return to Oracle button

Most likely normal web session, lost PunchOut session, or cart template not rendering the return action.

400 / invalid setup

Check incoming cXML body, endpoint URL, buyer identity, content type, and Shared Secret.

Catalog opens but cart fails

Check product add-to-cart flow, session restore, and PrestaShop cart behavior.

Return fails

Check BrowserFormPost URL, HTTPS, buyer acceptance, and posted payload format.

If Return to Oracle is missing

  1. Confirm the buyer launched from procurement, not a normal store URL.
  2. Check logs for setup success and session restore success.
  3. Add an item and check whether add-to-cart is logged.
  4. Go to cart and verify PunchOut return action renders.
  5. If session context is missing, test restore from buyer cookie and URL/session handoff.
Fast customer question
Ask: “After launching from Oracle and adding an item, do you see a Return to Oracle button on the cart page?”

Useful log checkpoints

CheckpointMeaning
SETUP / IN-SETUPIncoming request reached the supplier endpoint.
SETUP_OUT_OKSupplier returned a successful setup response.
SESSION_SAVE_OKPunchOut session was stored.
RESTORE_SUCCESSCatalog or cart page restored PunchOut context.
ADD_OKItem was added inside the session.
OUT_RETURN_POSTSystem attempted to post the cart back to buyer.

Support bundle checklist

  • Platform version and PunchOutHub version.
  • Screenshot of buyer profile with secrets masked.
  • Masked logs around the failed test.
  • Exact step where it fails: setup, catalog, add cart, return cart, or PO.
  • Sample cXML request if available.
Need help?

Send platform version, buyer requirement, and masked logs for review.

Open next guide
Free readiness tool

Check your PrestaShop environment before a PunchOut project.

Use the free PunchOut Readiness Checker & Audit Report v1.4 to review version, PHP, SSL, theme/module risk, PunchOut readiness, and optional buyer requirement status before implementation or migration planning.

Download Free ToolView compatibility guide