FAQ

common questions about forter agentic orchestration general what is forter agentic orchestration? forter agentic orchestration is an orchestration layer that enables merchants to sell products through ai shopping agents like chatgpt, google gemini, and perplexity it connects your existing e commerce infrastructure to ai platforms without requiring you to rebuild your backend how is this different from traditional e commerce? in traditional e commerce, customers browse websites and complete checkout forms with agentic commerce, ai assistants handle product discovery, comparison, and checkout on behalf of consumers through conversational interfaces forter agentic orchestration provides the infrastructure that makes this possible which ai platforms are supported? openai/chatgpt — via the agentic commerce protocol (acp) google gemini — via merchant center perplexity — optimized for citation based shopping private/enterprise agents — via universal commerce protocol (ucp) do i need to change my existing e commerce platform? no forter agentic orchestration is designed to work with your existing infrastructure you continue using shopify, salesforce commerce cloud (sfcc), or your custom backend forter agentic orchestration acts as a bridge, not a replacement integration which integration method should i choose? choose based on your e commerce setup shopify integration — if you use shopify, forter pulls your catalog via the admin api and creates orders as draft orders no feed hosting needed sfcc integration — if you use salesforce commerce cloud, forter pulls your catalog via ocapi and creates orders directly no feed hosting needed custom integration — if you built your own commerce backend, host a product feed (google merchant center xml, shopify csv, or json) at a stable url and implement three merchant endpoints (account, cart, checkout) to handle the checkout lifecycle see quickstart guide docid\ z0ifg9eupdpzstkiqdq0k for detailed integration paths what are the three merchant endpoints for custom integration? custom integration requires three post endpoints that forter calls during the checkout flow account endpoint — receives account login events to look up customer accounts by email/phone returns account status ( active , blocked , not found ) non fatal — if it fails, checkout continues cart endpoint — receives cart created and cart updated events with items, buyer, and recipient details must return priced items, shipping options, and totals (all prices in dollars, not cents) fatal — if it fails, checkout cannot proceed checkout endpoint — receives order created events with items, buyer, recipient, payment (provider + token + card metadata), and totals must process payment and return an order id fatal — if it fails, the order is not created see custom integration guide docid\ ntmq78zxvpnasxhkcjkpi for full request/response schemas what is the reference id and how is it used? the reference id is a sticky identifier that lets you correlate calls across the three merchant endpoints within a single checkout flow any endpoint response can include a reference id field, and forter will pass it to all subsequent endpoint calls for example, your account endpoint might return a reference id that gets included in the cart and checkout requests, allowing you to link all three calls to the same customer session in your system what product feed formats are supported? feed formats are only needed for custom integration google merchant center xml — standard shopping feed format shopify csv — native shopify product export format json — custom json format for shopify and sfcc , forter pulls your catalog directly via apis—no feed hosting needed how often should i update my product feed? for custom integration , configure your feed update frequency in the forter portal daily — suitable for most merchants hourly — for high velocity inventory custom — contact forter for specific schedules for shopify and sfcc , forter continuously syncs your catalog use the /v1/inventory endpoint for real time updates between syncs can i update inventory in real time? yes the /v1/inventory endpoint accepts single updates or batches of up to 100 items updates are processed immediately and reflected to ai platforms how long does feed processing take? feed processing depends on catalog size < 10,000 products minutes 10,000 100,000 products under an hour > 100,000 products a few hours what happens to products missing from a new feed? products not present in a full feed sync are soft deleted (marked as unavailable), not permanently removed this prevents accidental catalog loss from incomplete feeds checkout & payments how does checkout work with ai agents? ai agent creates a checkout session with selected products user provides shipping address through the ai interface forter agentic orchestration calculates tax and finalizes totals agent submits payment credentials to pci compliant vault forter agentic orchestration processes payment and proxies order to your backend do i need to be pci compliant? no forter agentic orchestration uses a delegated payment model where card data only touches our pci compliant vault your servers never see raw card numbers, removing you from pci scope who handles payment processing? by default, you handle payments on your side (recommended for most merchants) forter creates orders in your system with payment references you process payments through your existing payment provider you handle fraud checks through your existing rules optionally, forter can handle payments (requires additional configuration) forter validates orders for fraud before creation forter authorizes/captures payments via forter payment orchestration orders are created in your system with completed payment status supported providers stripe, adyen, braintree, or custom psp contact your forter representative to enable forter side payment processing can customers use saved payment methods? yes, if your backend supports card on file forter agentic orchestration can reference existing customer payment tokens rather than requiring new card entry how is tax calculated? forter agentic orchestration includes a us sales tax engine with state and county rate lookups nexus aware calculation (only states where you're registered) category specific rules (clothing exemptions, food rates) tax holiday detection security & compliance how are api keys secured? api keys are securely hashed before storage—the raw key is never stored and cannot be retrieved if you lose a key, a new one must be generated is the platform pci compliant? yes payment operations occur on a separate pci dss level 1 compliant domain the non payment domain never handles card data how is fraud prevented? every transaction is protected by forter identity intelligence, which analyzes device and behavioral signals network patterns historical transaction data real time risk scoring can i restrict api access by ip? yes contact your forter representative to configure ip allowlisting for your api keys operations how do i monitor my integration? the forter dashboard provides catalog health — feed sync status, product counts, validation errors transaction volume — checkout sessions created, completed, failed semantic hits — how often ai agents discover your products error rates — failed checkouts, payment declines what happens if an ai agent tries to buy an out of stock item? forter agentic orchestration validates inventory at checkout session creation out of stock items are rejected with a clear error the inventory heartbeat feature keeps stock levels synchronized to minimize stale data how do i handle returns for agentic orders? returns are handled through your normal process orders proxied to your backend include all necessary customer and order information for standard return workflows is there a sandbox for testing? yes use sk test api keys to access sandbox mode no real payments processed orders not sent to your backend test card numbers accepted full api functionality available pricing & support what support is available? documentation — this documentation site technical support — via your forter representative dashboard — self service monitoring and configuration integration assistance — dedicated support during onboarding is there an sla? yes production environments include uptime slas contact your forter representative for specific terms troubleshooting troubleshooting guide my feed is not syncing (custom integration) url accessibility — verify your feed url returns 200 ok and is publicly accessible (or properly authenticated) format — ensure the format matches what you specified ( google = xml, shopify = csv, json = json) content type — use application/xml for xml feeds, text/csv for csv feeds, application/json for json feeds file size — ensure the file isn't empty and is under 500mb response time — feed must respond within 30 seconds authentication — if using http basic auth or other authentication, verify credentials are correct in forter portal my merchant endpoints are failing (custom integration) use the portal test tool — navigate to merchant platform > test endpoints in the forter portal to run automated tests against all three endpoints check authentication — if bearer token auth is enabled, verify your endpoint checks authorization bearer {secret} if hmac signing is enabled, verify signature validation logic cart endpoint — ensure you return items with price , effective price , subtotal ; a shipping options array; and a totals object all prices must be in dollars (decimal), not cents checkout endpoint — ensure you return { "success" true, "order id" " " } and that payment processing completes within 10 seconds account endpoint — this endpoint is non fatal; failures here won't block checkout but may affect account correlation response format — all endpoints must return content type application/json my catalog is not syncing (shopify/sfcc) api credentials — verify your admin api access token (shopify) or ocapi client id/secret (sfcc) are correct api permissions — ensure proper scopes/permissions are configured (see platform specific integration guides) rate limits — check if you're hitting shopify/sfcc api rate limits product visibility — verify products are published and active in your platform dashboard logs — review forter portal logs for specific sync errors i'm getting 401 unauthorized errors key format — ensure the header is authorization bearer sk (with space after bearer) key validity — verify the key hasn't been rotated or revoked environment — test keys don't work in production and vice versa inventory updates aren't reflected identifier match — verify the id , gtin , or mpn matches a product in your catalog response check — review the results array in the response for specific errors processing delay — updates are near instant but allow a few seconds for propagation orders aren't appearing in my backend integration status — verify your order proxy is configured correctly in the forter dashboard endpoint urls — if using custom integration, ensure all three endpoint urls (account, cart, checkout) are accessible and returning 200 ok use the portal endpoint test tool to validate platform credentials — if using shopify/sfcc, verify your api credentials are valid dashboard logs — check the forter dashboard for order delivery errors cart endpoint — if the cart endpoint fails, checkout cannot proceed and no order will be created still have questions? contact your forter representative or email support for additional assistance related documentation quickstart guide docid\ z0ifg9eupdpzstkiqdq0k — step by step integration guide catalog & inventory docid\ zi2ppkf2jiiqfyijnqbui — product data synchronization checkout & payments docid\ vd6rt6wkn75pli dxv5he — payment processing and order management