GOHIGHLEVEL ANSWERS & PROMPTS: PLAYBOOK T80 · EXTERNAL CART TO GOHIGHLEVEL INVOICE API CHECKOUT & PAID TRIGGER
AUTHOR: DANIEL HALLMAN
KEYWORD: CART CHECKOUT
PLAYBOOK T80 · External Cart to GoHighLevel Invoice API Checkout & Paid Trigger KEYWORD: CART CHECKOUT

How Do You Connect an External Webflow Cart to a GoHighLevel Checkout Without Making Customers Re-Select Items?

Answer: GoHighLevel order forms do not accept dynamic multi-item cart arrays over URL query parameters, and calling POST /invoices/text2pay with action set to draft only returns an unpayable preview URL. To hand off a multi-item Webflow cart to a live GoHighLevel card checkout, post the selected item IDs and quantities to your backend endpoint, upsert the contact and call POST /invoices/text2pay with action: 'send' and liveMode: true using a scoped Private Integration token from Settings > Private Integrations, then redirect the browser to the returned invoiceUrl and trigger fulfillment in Automation > Workflow Builder on Invoice (Status = Paid).

STEP-BY-STEP INSTRUCTIONS + ANNOTATED GHL SCREENSHOTS

Steps in GoHighLevel

  1. STEP 1
    In Settings > Private Integrations, create a server-side token scoped to contacts.write and invoices.write (keeping the token on your backend or Cloudflare Worker, never in Webflow frontend code) and have your Webflow checkout button POST the shopper's email, item IDs, and quantities to your server endpoint.
    REAL GHL SCREEN · SETTINGS > PRIVATE INTEGRATIONS (API V2) ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Private Integrations API v2.0 screenshot showing Settings > Private Integrations menu, Create New Integration button, and scoped token audit row
    1Open Settings > Private Integrations 2Click Create New Integration 3Review Scoped Token & Last Used Date
  2. STEP 2
    In your backend endpoint (or Payments > Invoices API integration), upsert the customer contact ID, look up the authoritative item prices on the server, and call POST /invoices/text2pay with each cart item in items[], liveMode: true, and action: "send" so the returned invoiceUrl renders the live card payment checkout instead of a draft preview.
    REAL GHL SCREEN · SITES > FUNNELS, FORMS & CHAT WIDGET ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Sites screenshot showing Sites menu, Funnels/Forms/Chat Widget top bar, and + New Funnel button
    1Click Sites in Left Sidebar 2Switch Between Funnels, Forms & Chat Widget 3Click + New Funnel or Build with AI
  3. STEP 3
    In Automation > Workflow Builder, create a workflow triggered on Invoice (Invoice Status = Paid) to tag the buyer, write the purchased line items to the contact or opportunity record, and send the order confirmation.
    REAL GHL SCREEN · AUTOMATION > WORKFLOW BUILDER CANVAS ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Workflow Builder canvas screenshot showing If/Else condition branch, priority routing steps, and Builder/Settings/Execution logs tabs
    1Add If/Else Condition & Tag Guard 2Chain Priority & Wait Steps 3Switch to Settings or Execution Logs
MODE: AGENT PROMPT
PASTE INTO CLAUDE CODE, CURSOR, CHATGPT, OR GOHIGHLEVEL ASK AI AGENT PROMPT
Configure a multi-item external cart to GoHighLevel invoice checkout and post-payment workflow in sub-account <YOUR_LOCATION_ID>:
1. In Settings > Private Integrations, verify a server-side token with contacts.write and invoices.write scopes for the backend cart-to-invoice handoff.
2. Have the backend upsert the contact and call POST /invoices/text2pay with items[], liveMode: true, and action: "send", then redirect the customer to the returned invoiceUrl.
3. In Automation > Workflow Builder, build a fulfillment workflow triggered by Invoice (Status = Paid) to update the opportunity stage and send the receipt.
Cause
  • When a visitor selects multiple items in an external Webflow cart and clicks Continue to Payment, sending them to a static GoHighLevel funnel page forces them to pick their items all over again.
  • Developers who look up the HighLevel Invoices API often get stuck on POST /invoices/text2pay because the API documentation describes invoiceUrl as a preview link, which happens whenever the invoice is created in draft status rather than sent status.
GoHighLevel Configuration
  • Create a server-side checkout endpoint authenticated with a Settings > Private Integrations token (invoices.write, contacts.write), call POST /invoices/text2pay with action: "send" and liveMode: true so invoiceUrl opens the live card payment form for all cart line items
  • and trigger post-purchase automation from Invoice (Status = Paid) in Automation > Workflow Builder.
MENU PATH REFERENCE

GoHighLevel Menu Paths

Step Menu Path in GHL Action
Step 1 Settings > Private Integrations Create a server-side token scoped to contacts.write and invoices.write (keeping the token on your backend or Cloudflare Worker, never in Webflow frontend code) and have your Webflow checkout button POST the shopper's email, item IDs, and quantities to your server endpoint.
Step 2 Payments > Invoices Upsert the customer contact ID, look up the authoritative item prices on the server, and call POST /invoices/text2pay with each cart item in items[], liveMode: true, and action: "send" so the returned invoiceUrl renders the live card payment checkout instead of a draft preview.
Step 3 Automation > Workflow Builder Create a workflow triggered on Invoice (Invoice Status = Paid) to tag the buyer, write the purchased line items to the contact or opportunity record, and send the order confirmation.
3-step diagram showing Send cart items posting item IDs to your server, Call text2pay API setting action to send in liveMode, and Trigger paid flow running fulfillment when invoice is paid.
VISUAL PLAYBOOK · PLAYBOOK T80 (EXTERNAL CART TO GOHIGHLEVEL INVOICE API CHECKOUT & PAID TRIGGER) Back to Annotated GHL Screenshots ↑
DEFAULT SETUP VS. AUTOMATED WORKFLOW

Operational Comparison

Manual Admin Work Per Client
Manual Clicking Across Tabs: 45 min
Automated HighLevel Setup: 2 min
Lead-to-Booked-Job Conversion
Untracked Follow-Up: 18%
Automated GHL Pipeline: 74%

Related Questions

BUILD FASTER IN GOHIGHLEVEL · FREE TRIAL BONUSES + MCP SERVER

Build this directly inside your GoHighLevel sub-account

Connect Claude Code, Cursor, or OpenAI Codex to our ghl-tools MCP Server & Rust CLI to build workflows, forms, and funnels from your editor, or start your GoHighLevel plan through our partner link to unlock $612+ in ready-to-import kits (including GHL Invoice API Checkout & Payment Webhook Kit) and weekly live clinics.