Define the payment owner before comparing features
Write down who accepts the customer credential, submits the financial operation and receives the verified result. Then identify who creates the order and who delivers the product. These roles can sit within one provider or several services, but they should not disappear inside a general “agent checkout” label.
Our fictional scenario is a $29 digital report sold by Cedar Research. The buyer authorizes one purchase up to $35 and expects access to the current edition. A suitable gateway route must process the permitted financial action and give Cedar an outcome it can join to the order. It does not automatically own the report entitlement or customer support.
Use the requirements worksheet to collect evidence from each provider. Its questions are recommendations for evaluation, not a claim that every provider supports every listed feature. Mark an unanswered question unknown, and identify the person or documentation needed to resolve it before accepting the route.
- RFP entry: Shared Payment Tokens — documented in Stripe’s agentic commerce material; validate the selected account, channel and credential contract separately.
- RFP entry: this merchant’s country, product and channel eligibility — unknown until current onboarding requirements confirm the exact combination.
- RFP entry: payment-to-order-to-delivery recovery — required by this merchant’s scenario; provider documentation and a configuration-specific test must establish which participant owns each step.
Gateway requirements worksheet
Check credentials and customer authority together
A gateway may use payment tokens, a hosted checkout or another supported credential mechanism. Inspect the actual integration contract: who obtains the credential, what it permits, where it can be used and how it expires. Do not assume every token has the same amount or merchant scope.
The buyer's authority is a separate input. A credential that can fund a payment does not explain whether Sam approved the report, a different license or a recurring subscription. Your checkout and payment design must preserve the connection between the permitted purchase and the financial operation.
Stripe describes Shared Payment Tokens as part of its agentic commerce infrastructure and positions merchant catalog, checkout and payment capabilities together. Those product claims are relevant to a shortlist. They do not by themselves establish account eligibility or demonstrate your own order recovery configuration. [1]
Confirm the actual market and product route
Ask for the supported seller location, buyer location, currency and product category for the specific agentic product. A provider can offer ordinary card processing in a market while a newer channel integration has narrower onboarding. A website translated into many languages does not answer the eligibility question.
Also verify how the intended shopping surface connects. A referral into your existing checkout and a native commerce-channel purchase can use different integration paths. If the provider supports one, do not advertise the other without current evidence. Keep the channel, provider account and store configuration together in the acceptance record.
For digital goods, ask how the payment result reaches the order and entitlement services. For physical goods, additional fulfilment and shipping questions would apply. This guide's report example does not prove a provider supports every product type. Use the actual scenario rather than a generic compatibility badge.
Understand the financial lifecycle and costs
Find the operation that authorizes, captures or otherwise settles payment for the supported route. Not every payment method uses the same sequence. Determine which result your merchant service should treat as sufficient to commit the order and what remains unresolved at each intermediate state.
Record the actual pricing terms that apply to your account and route. Separate processing costs, platform charges, channel charges and any relevant refund or dispute costs. Do not calculate a universal cheapest gateway from unrelated headline rates. An honest comparison needs the same assumed order mix and current source date.
For Cedar, the customer's $29 purchase amount is a teaching value. It is not a provider fee or an estimate of what the merchant receives net of charges. Keep gross order value, actual fees and settlement amounts as separate quantities in your accounting design. That makes later reconciliation more understandable.
Require a retrievable outcome after uncertainty
A lost response can occur after the financial operation completes. The agent and merchant service need a supported way to retrieve or resolve the existing attempt. A second charge should not be the default recovery action just because the first call timed out.
Ask the provider how idempotency works for the exact operation you will use. Determine the scope, supported reuse behavior and handling of conflicting parameters from current documentation. Then check that the merchant integration preserves that behavior. A provider feature does little if your adapter generates a new unrelated operation every time.
Keep tracing identifiers separate from business operation references. Support should be able to locate both an individual failed request and the purchase it concerned. Preserve the provider reference in the order record without exposing credentials. An assistant-generated sentence saying “payment succeeded” is not a substitute for the authoritative result.
Verify events at the correct boundary
Providers can send events about financial state. Your service should verify those events through the provider's supported mechanism, resolve repetition consistently and join the result to the correct order. Do not use a generic header name or signature algorithm invented for a tutorial.
The event trail below is conceptual. It deliberately avoids pretending that an illustrative field list is an official provider webhook payload. The implementation needs the actual event type, identifier, signing rules and state semantics from its selected provider. Record those specifics in the integration runbook.
A merchant-to-channel order notification is a different event from a provider-to-merchant payment notification. Name both directions clearly. Otherwise an operator may mistake an outbound “order created” message for independent evidence that a payment provider confirmed money movement.
For an illustrative evidence record, use event EVT-31, payment PAY-31, order O-31, provider-signature check passed, retrieved financial state confirmed, and order transition applied once. If EVT-31 arrives again, retain the original business result and record the repeat. These fictional labels show the audit relationship only: they are not a signed payload, a signature value, an actual test log or proof that any provider uses those field names.
Conceptual verified payment event trail
- Provider event
A financial-state event reaches the merchant endpoint.
- Verification
The merchant applies that provider’s actual signature and event rules.
- Resolution
The handler joins the event to the existing payment and order.
- Order update
A controlled transition records the current financial outcome.
- Fulfilment
The delivery service acts on the appropriate committed order state.
Inspect refunds, disputes and failed delivery
A gateway's refund function is useful only if the merchant can connect it to the original payment and track its real outcome. Ask about supported partial refunds, pending results and failures for the chosen payment method. Do not assume every rail has a card-style chargeback process.
The gateway may process money without handling fulfilment. If the report download fails, the merchant should keep the paid order, recover delivery or apply its disclosed resolution policy. A provider's successful response does not prove that the customer received usable access to the purchased edition.
Assign an owner for mismatched records. If the payment provider says confirmed while the store has no order, someone must investigate the join. The customer should not have to buy again to repair that integration failure. Include a support view that exposes relevant references and the next action without exposing raw credentials.
Ask how the provider reports incidents and changes that affect this particular integration. Record the operational contact route, relevant service status source and who can pause new purchases safely. A pause should preserve existing payment and order references so support can resolve customers who already paid. Also establish how you re-evaluate a route after a provider version change. The acceptance matrix should be rerun for affected behavior, rather than assuming that an unchanged product name means the financial contract is unchanged.
Evaluate the provider through a bounded acceptance plan
Use the same report scenario for each shortlisted route. Run a normal purchase, changed total, unsupported credential, repeated completion and lost response. Include a payment-confirmed delivery failure so the merchant can demonstrate recovery against the existing order.
Write the expected result first and preserve the implementation version and configuration. These scenarios are evaluation recommendations, not evidence that this guide tested a provider. Replace vendor statements with observed configuration-specific results only when you actually have those records.
A suitable agentic commerce payment gateway leaves the merchant with a verifiable financial outcome and a clear operational contract. Your final choice should explain why the route fits the product, channel and customer authority, which team handles exceptions and which questions remain open. That explanation is more durable than an overall star rating without visible evidence.