PunchOutHub Docs

Buyer Setup Guide

A buyer profile keeps procurement-side identity, authentication, return URL, and support context separated per customer. This makes testing and support easier when you support one buyer today and more buyers later.

Buyer identitySender ID and credential matching
AuthenticationShared Secret must be protected and masked
Return pathBrowserFormPost / Return URL controls cart return

Required buyer fields

FieldPurposeCheck
Buyer nameHuman-readable account labelUse the company or buyer portal name.
Sender ID / IdentityMatches incoming cXML credentialMust match buyer-provided value exactly.
Shared SecretAuthenticates incoming setup requestNever publish or export unmasked.
BrowserFormPost URLWhere the cart is returnedUse HTTPS unless buyer specifies otherwise.
StatusControls buyer availabilityDisable unused buyer profiles instead of deleting too early.

Setup process

  1. Create buyer profile.
  2. Enter buyer identity values supplied by the procurement team.
  3. Set Shared Secret.
  4. Add BrowserFormPost / Return URL.
  5. Save and re-open the buyer profile to confirm persistence.
  6. Run PunchOutSetupRequest test.
  7. Review masked logs for identity match and setup response.

Edition and buyer count

Single Buyer is suitable for one company / one buyer portal. Business 1:5 is better for suppliers that expect multiple buyer profiles. Enterprise or add-on scope can be used for mapping, OCI, or additional buyer-specific requirements.

Sales clarity
Business 1:5 should be positioned as “support up to five buyer profiles,” not as unlimited procurement integration.

Support data to collect

  • Buyer system name and buyer contact.
  • Sender ID / credential domain with secrets masked.
  • Return URL with sensitive query strings removed if needed.
  • Sample setup request if buyer can provide it.
  • Masked PunchOutHub logs after the test.
Next: PunchOut flow

Explain the full PunchOut request, catalog, return, and PO flow.

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