{"object":"list","data":[{"object":"doc","slug":"getting-started","title":"Getting started","summary":"Confirm your key, learn the conventions, and see what you can build today, in five minutes.","tags":["guide","onboarding"]},{"object":"doc","slug":"connect-your-agent","title":"Connect your coding agent","summary":"Connect Claude Code, Cursor, or the Claude API with your API key from the environment, or sign the Claude app, ChatGPT or Cursor in with your email.","tags":["guide","mcp","onboarding"]},{"object":"doc","slug":"api-conventions","title":"API conventions","summary":"Objects, lists, ids, integer amounts, request ids, and bounded idempotency conventions for the supported API.","tags":["guide","conventions","idempotency"]},{"object":"doc","slug":"errors","title":"Errors","summary":"One envelope, a small set of types, and stable codes you branch on instead of parsing messages.","tags":["guide","errors"]},{"object":"doc","slug":"accept-a-terminal-payment","title":"Accept a card-present payment in five calls","summary":"Create a merchant and a simulated terminal, push a payment, choose the outcome, and read the result, with no hardware.","tags":["guide","payments","terminals","sandbox"]},{"object":"doc","slug":"accept-a-keyed-payment","title":"Accept a keyed (card-not-present) payment","summary":"Embed the hosted card form, get a one-time nonce in the browser, and charge it with one request that returns the final result.","tags":["guide","payments","keyed","collect"]},{"object":"doc","slug":"handle-every-payment-state","title":"Handle every payment state","summary":"The payment state machine, every failure_code, and how to wait for a result without guessing.","tags":["guide","payments","states","errors"]},{"object":"doc","slug":"webhooks","title":"Webhooks: register, verify, retry","summary":"Register an HTTPS endpoint (an empty filter means payment events only; billing events are opt-in), verify the ZeroPoint-Signature header in ten lines, handle retries and out-of-order events, catch up from the event list, and rotate secrets without downtime.","tags":["guide","webhooks","events","security"]},{"object":"doc","slug":"refunds-and-voids","title":"Refunds and voids","summary":"Reverse a succeeded payment in full or in part, know when to void instead, and read the result.","tags":["guide","refunds","payments"]},{"object":"doc","slug":"modes-and-terminals","title":"Modes, terminals, and payment methods","summary":"Test versus live keys, physical versus simulated terminals, and card-present versus keyed entry, explained once.","tags":["concept","terminals","sandbox"]},{"object":"doc","slug":"whats-available","title":"What is available in this release","summary":"The exact endpoints and MCP tools that exist right now, and what arrives next, so you never guess at a URL.","tags":["concept","roadmap"]},{"object":"doc","slug":"collect","title":"The hosted card form","summary":"ZeroPoint hosts the card form; your page embeds it in an iframe and receives a one-time nonce over postMessage, so card data never touches your code.","tags":["concept","keyed","collect","security"]},{"object":"doc","slug":"terminal-hardware","title":"Terminal hardware and discovery","summary":"Which card readers exist, how serial numbers tell physical from virtual devices, and what discovery returns.","tags":["concept","terminals","hardware"]},{"object":"doc","slug":"processor-rails","title":"How money moves (powered by GoDaddy Payments)","summary":"Sandbox orchestration, which reversal applies when, and preserving identity through uncertain outcomes.","tags":["concept","compliance","settlement"]},{"object":"doc","slug":"sandbox","title":"How the sandbox works","summary":"What is real and what is simulated with a test key, how simulated terminals behave, and how to exercise every outcome.","tags":["concept","sandbox","testing"]},{"object":"doc","slug":"reconciliation","title":"Reconciliation","summary":"How we catch the ways our records can drift from the processor's, the promise we hold to when we do, and every event and reason a reconciliation pass can produce.","tags":["guide","reconciliation","webhooks","refunds"]},{"object":"doc","slug":"integration-snippets","title":"Tested integration components","summary":"Retrieve complete reviewed code, instructions and tests through MCP before building payment plumbing from scratch.","tags":["guide","agents","snippets","webhooks"]},{"object":"doc","slug":"integrate-antique-store-pos","title":"Integrate an antique-store POS with the terminal reference components","summary":"A read-first recipe for composing the reviewed Node terminal checkout, webhook receiver and order-evidence components into an existing antique store POS.","tags":["guide","agents","snippets","terminals","sandbox"]},{"object":"doc","slug":"ui-components","title":"Place payment UI in your app","summary":"Reuse checkout, status, receipt and error panels with explicit host callbacks and uncertain-outcome handling.","tags":["guide","ui","components","accessibility","agents"]},{"object":"doc","slug":"troubleshoot-terminal-integration","title":"Troubleshoot a terminal integration safely","summary":"Read checkout snapshots, webhook receiver responses, and order-evidence dispositions without retrying an uncertain payment.","tags":["guide","payments","terminals","webhooks","troubleshooting"]},{"object":"doc","slug":"connect-a-merchant","title":"Connect a merchant's own payments account","summary":"A merchant opens a GoDaddy Payments account through ZeroPoint's referral link, then connects it to your merchant record in one click; from then on their payments run on their own account.","tags":["guide","merchants","live","onboarding"]},{"object":"doc","slug":"explain-payment","title":"Explain a stored payment","summary":"Read payment and reversal evidence with explicit uncertainty, without another processor request.","tags":["guide","payments","refunds","troubleshooting"]},{"object":"doc","slug":"going-live","title":"Before your first live payment","summary":"Connect the merchant's account, verify webhook delivery and complete acceptance before using live payment writes.","tags":["guide","live","onboarding"]},{"object":"doc","slug":"billing-webhooks","title":"Billing webhooks: Stripe-shaped events, and where they differ","summary":"Billing events (checkout, invoice, subscription, customer, payment method) are opt-in, Stripe-shaped, and carry both Stripe period layouts. How to subscribe, verify, catch up, and port a Stripe handler, with the event mapping table.","tags":["guide","webhooks","billing","events","stripe"]},{"object":"doc","slug":"checkout","title":"Hosted checkout","summary":"A checkout session is a ZeroPoint-hosted payment page for a fixed amount. You create it on your server, send the buyer to its url, and fulfil on the checkout.session.completed webhook.","tags":["concept","checkout","payments","keyed"]},{"object":"doc","slug":"accept-payments-with-checkout","title":"Accept payments with hosted checkout","summary":"Create a checkout session on your server, redirect the buyer to its url, fulfil once per session on the checkout.session.completed webhook, and check the session before showing paid.","tags":["guide","checkout","payments","webhooks"]},{"object":"doc","slug":"catalog","title":"Catalog: products, prices, coupons and promotion codes","summary":"How to set up what a merchant sells (products and immutable prices, monthly, yearly or one time) and its discounts (coupons and promotion codes), with a worked example in integer cents, the discount math, and the limits of this version.","tags":["concept","catalog","billing","prices","discounts","stripe"]},{"object":"doc","slug":"saved-cards","title":"Saved cards (card on file)","summary":"Customers and saved payment methods. What ZeroPoint stores, the status of a saved card and why it becomes unusable, who holds the cardholder's agreement, and what is not offered.","tags":["concept","card-on-file","payments"]},{"object":"doc","slug":"customers","title":"Customers","summary":"Create, read, change and delete the customers of a merchant, the owners of saved cards; the fields, the Stripe id link, what a delete refuses and what it erases, and the customer events.","tags":["guide","customers","billing","stripe"]},{"object":"doc","slug":"migrate-from-stripe-checkout","title":"Migrate from Stripe Checkout","summary":"How Stripe Checkout Session names map to ZeroPoint checkout sessions, what is the same, what differs, and what is not supported.","tags":["guide","checkout","migration"]},{"object":"doc","slug":"save-a-card","title":"Save a card for later charges","summary":"Create a customer, show the merchant's terms, take the card in the hosted form in save mode, and save it, alone or with a first payment in the same call.","tags":["guide","card-on-file","collect"]},{"object":"doc","slug":"charge-a-saved-card","title":"Charge a saved card","summary":"Charge a saved payment method with method card_on_file, handle every outcome, and retry without ever charging twice.","tags":["guide","card-on-file","payments"]},{"object":"doc","slug":"migrate-from-stripe-catalog","title":"Move a catalog from Stripe","summary":"Recreate your Stripe products, prices, coupons and promotion codes in one ZeroPoint merchant with a Stripe restricted read-only key; the dry run, what is recreated, what is not and why, and why customers and saved cards do not move this way.","tags":["guide","catalog","stripe","migration","prices","discounts"]},{"object":"doc","slug":"subscriptions","title":"Subscriptions and invoices","summary":"How a subscription and its invoices behave: statuses, when the period moves, holds while a charge is being confirmed, plan changes, cancels, refunds, the customer portal, and what runs only on test clocks in this release.","tags":["concept","billing","subscriptions","invoices"]},{"object":"doc","slug":"build-subscriptions","title":"Sell a subscription in five calls","summary":"A monthly plan end to end in the sandbox. Create a product and a recurring price, open a checkout session in subscription mode, provision on the webhook, and give the customer the portal. With the MCP tool for each call.","tags":["guide","billing","subscriptions","checkout","webhooks"]},{"object":"doc","slug":"upgrades-downgrades-and-cancel","title":"Upgrades, downgrades and cancel","summary":"Change a subscription's plan or end it. Upgrades charge the prorated difference now and switch only after the charge is captured; downgrades wait for the period end; cancel is at period end, or now when you must.","tags":["guide","billing","subscriptions"]},{"object":"doc","slug":"failed-renewals-and-retries","title":"Failed renewals and retries","summary":"What happens when a renewal is declined. The retry schedule (+1, +3, +7 days by default, at most 8 retries), hard declines that are never retried and block the card, the per-card attempt ceilings, the final action, and what your app should do at each step.","tags":["guide","billing","subscriptions","dunning","declines"]},{"object":"doc","slug":"test-billing-with-test-clocks","title":"Test your billing with test clocks and failure injection","summary":"Run renewals, declines, retries, reminders and period ends in seconds. A test clock moves a customer's subscriptions through time with the real billing code; fail_next_charges makes a test card's next charges decline or go unknown. Test mode only.","tags":["guide","billing","subscriptions","sandbox","testing"]},{"object":"doc","slug":"billing-events","title":"Billing events reference","summary":"Every billing event type, when it fires, what data.object holds, and what your handler should do with it, including invoice.upcoming three days before a renewal. ZeroPoint sends no email to your customers; your app sends its own from these events.","tags":["guide","billing","webhooks","events","subscriptions","reference"]},{"object":"doc","slug":"coming-from-stripe","title":"Coming from Stripe","summary":"Point the official Stripe SDK at ZeroPoint by changing the base URL and the key. Which billing calls work today, which are refused by name and what to use instead, and the behaviour differences a ported app must handle.","tags":["guide","billing","stripe","migration","subscriptions"]}],"has_more":false,"next_cursor":null,"url":"/v1/docs"}