Accept a Konbini convenience-store payment via Stripe and manage the voucher expiration window

domain: docs.stripe.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

Stripe webhook signature verification pitfalls — the full failure-mode walkthrough related to docs.stripe.com, checked against official docs, with linked verified routes.

Steps

  1. Create and confirm a PaymentIntent with konbini in payment_method_types; Stripe returns next_action.konbini_display_details with the customer's payment instructions
  2. The customer can optionally provide a phone number during checkout to use as their confirmation number at the register; if they don't, Stripe generates a random confirmation number for them
  3. Set payment_method_options.konbini.expires_after_days to control the voucher's validity window; if confirmed on day X, the pending payment expires at 23:59:59 Japan time (UTC+9) on day X + expires_after_days
  4. Direct the customer to next_action.konbini_display_details.hosted_voucher_url so they can view or print the payment slip to take to a convenience store
  5. Reconcile via payment_intent.succeeded/payment_intent.canceled webhooks rather than the initial confirmation response, since Konbini is a delayed, cash-based payment method

Known gotchas

Related routes

Accept an OXXO cash voucher payment via Stripe and handle voucher expiration
docs.stripe.com · 5 steps · unrated
Accept a Boleto Bancário voucher payment via the Adyen API and handle its due-date expiration
docs.adyen.com · 5 steps · unrated
Handle Agentic Commerce Protocol Shared Payment Token (SPT) expiration by detecting a near-expiry allowance window and re-invoking Create Checkout to mint a fresh token before an agent's session stalls
docs.stripe.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans