# Therius

## Documentation

### Get Started

- [Therius: Unified Payment API for Cards and Wallets](https://docs.therius.io/introduction.md): Therius is a unified payment API for cards, wallets, and alternative/local payment methods. Learn what Therius does and how it fits your integration.
- [Therius Quickstart: Your First Payment in 5 Minutes](https://docs.therius.io/quickstart.md): Send a real sandbox payment with the Therius API in under five minutes — no SDK needed, no frontend setup. Just a key and a curl command.
- [Therius API Authentication — Keys and Environments](https://docs.therius.io/authentication.md): Learn how Therius API keys work, how to pass them in requests, the difference between live and sandbox credentials, and how to mint SDK session tokens.
- [Idempotency: Safely Retry Payments Without Duplicates](https://docs.therius.io/idempotency.md): Prevent duplicate charges by using the Idempotency-Key header on all mutating Therius API calls. Learn how idempotency works and best practices.

### Core Concepts

- [Payment Lifecycle: Authorize, Capture, Refund, and Cancel](https://docs.therius.io/concepts/payment-lifecycle.md): Understand the Therius payment lifecycle — authorization, capture, partial refunds, and voiding — and choose the right flow for your use case.
- [Smart Routing: Connections, Rules, and Failover](https://docs.therius.io/concepts/smart-routing.md): How Therius routes each payment across your connected providers — routing rules, cascading failover, and where 3D Secure and fraud screening fit in the pipeline.
- [Declined Payments: Refusal Codes and Recovery Actions](https://docs.therius.io/concepts/declined-payments.md): How Therius reports a declined payment — the refusalCode object, the recoveryAction hint, and the full table of normalized ISO 8583 refusal codes with their meanings.
- [Card Tokenization: Store Cards for Future Payments](https://docs.therius.io/concepts/tokenization.md): Tokenize cards during a payment or via the standalone token API to charge returning shoppers without collecting card details again.
- [Therius 3D Secure: Handling Challenges and Resumption](https://docs.therius.io/concepts/3d-secure.md): How Therius handles 3DS2 challenges automatically — including the pending_3ds pause, device data collection, and the resume endpoint.
- [Therius Test and Production Environment Configuration](https://docs.therius.io/concepts/environments.md): Therius has two environments — sandbox and production. The API key prefix selects the environment automatically, with no extra configuration needed.

### Guides

- [Build a PCI-Safe Browser Checkout with Therius JS SDK](https://docs.therius.io/guides/browser-checkout.md): Step-by-step guide to building a PCI-safe browser checkout with Therius hosted fields or the drop-in widget — card numbers never touch your server.
- [Build Recurring Billing with Therius Subscriptions](https://docs.therius.io/guides/subscriptions.md): Create plans, enroll customers in subscriptions, handle dunning, and manage plan changes, pauses, and cancellations with the Therius subscription API.
- [Accept Alternative Payment Methods (APMs) with Therius](https://docs.therius.io/guides/alternative-payment-methods.md): Add Pix, ACH, iDEAL, Klarna, and 40+ more payment methods through the same purchase endpoint — just change the paymentMethod field.
- [Charge Saved Cards Using Stored Credentials and MIT](https://docs.therius.io/guides/stored-credentials.md): Use stored credentials to charge customers without them being present — recurring billing, installments, and unscheduled MIT payments with Therius.
- [Test Cards and Sandbox Scenarios for Therius](https://docs.therius.io/guides/testing.md): Every sandbox test card, decline reason, and 3D Secure scenario for the Therius API — plus how APM and subscription flows behave in the sandbox.

### Webhooks

- [Therius Webhooks: Delivery, Retries, and Signature Verification](https://docs.therius.io/webhooks/overview.md): Receive payment and subscription events from Therius over HTTPS. Configure an endpoint, verify the X-Therius-Signature header, and handle retries idempotently.
- [Therius Webhook Events Catalog and Payloads](https://docs.therius.io/webhooks/events.md): Every webhook event Therius sends — payment lifecycle, disputes, and subscription billing — with the payload shape for each family.

### AI Assistant

- [Therius AI: Thera and Bring Your Own AI](https://docs.therius.io/ai/overview.md): Therius exposes your payments, analytics, routing, disputes, and reconciliation data to AI — either through Thera, the in-dashboard assistant, or by connecting your own AI agent over MCP. No card data or secrets ever reach a model.
- [Thera: The In-Dashboard AI Assistant](https://docs.therius.io/ai/thera.md): Thera is an AI assistant built into the Therius dashboard. Ask about your payments, analytics, subscriptions, disputes, and settlements in plain language. It runs as you, scoped to your permissions, and never takes an action on its own.
- [Bring Your Own AI: Connect Claude, Cursor, or ChatGPT to Therius](https://docs.therius.io/ai/bring-your-own-ai.md): Point any MCP client or the REST tool surface at Therius with a user-scoped AI key. Your AI agent gets real, RBAC-enforced access to your payments, analytics, routing, and integration data — Therius hosts no model for this path.
- [Agent Keys: Let an AI Agent Conduct Bounded Commerce](https://docs.therius.io/ai/agent-keys.md): Give an autonomous agent a scoped, spend-capped key that can create real payment links over MCP — distinct from the read-only AI keys used for analytics.
- [Therius AI Tool Reference](https://docs.therius.io/ai/tools.md): Every tool available to Thera and to a connected AI agent, what it returns, and the capability and permission it requires.

### E-Commerce Plugins

- [E-Commerce Plugins for Therius](https://docs.therius.io/guides/plugins/overview.md): Official Therius plugins for WooCommerce, Magento 2, PrestaShop, and Shopware 6 — install, connect your keys, configure webhooks, and start accepting payments with smart routing.
- [Therius for WooCommerce](https://docs.therius.io/guides/plugins/woocommerce.md): Install and configure the Therius payment plugin for WooCommerce — sandbox and production keys, webhooks, and refunds.
- [Therius for Magento 2](https://docs.therius.io/guides/plugins/magento.md): Install and configure the Therius payment module for Magento 2 — sandbox and production keys, webhooks, and refunds.
- [Therius for PrestaShop](https://docs.therius.io/guides/plugins/prestashop.md): Install and configure the Therius payment module for PrestaShop — sandbox and production keys, webhooks, and refunds.
- [Therius for Shopware 6](https://docs.therius.io/guides/plugins/shopware.md): Install and configure the Therius payment plugin for Shopware 6 — sandbox and production keys, webhooks, and checkout behavior.

## API Reference

### Payments

- [Charge a Card in One Step](https://docs.therius.io/api-reference/purchase.md): Authorize and capture a payment in a single request. Use for digital goods or any order you fulfill immediately.
- [Place a Fund Reserve](https://docs.therius.io/api-reference/authorize.md): Reserve funds without capturing. Call capture later to settle, or cancel to release the hold. Ideal for physical goods.
- [Settle a Prior Authorization](https://docs.therius.io/api-reference/capture.md): Settle a previously authorized payment. Supports partial capture. Must be called within the acquirer authorization window.
- [Issue a Full or Partial Refund](https://docs.therius.io/api-reference/refund.md): Refund a captured payment in full or partially. Multiple partial refunds are allowed up to the total captured amount.
- [Release an Authorization Hold](https://docs.therius.io/api-reference/cancel.md): Void a payment that is still in the authorized state. Funds are released immediately. Cannot cancel a captured payment.
- [Reverse a Payment](https://docs.therius.io/api-reference/cancel-or-refund.md): Automatically cancels if the payment is authorized, or refunds if already captured. No need to track payment state.
- [Continue After a 3DS Challenge](https://docs.therius.io/api-reference/resume.md): Resume a payment paused for a 3DS challenge. Pass the sessionId from the pending_3ds response. No API key required.
- [Retrieve Payment Status](https://docs.therius.io/api-reference/inquiry.md): Retrieve the current status and full details of any payment using its paymentCode or internal payment UUID.

### Tokenization

- [Store Card Tokens for Future Payments](https://docs.therius.io/api-reference/store-tokens.md): Tokenize one or more cards without charging them. Each token is scoped to your merchant account and reusable for future payments.

### Subscriptions

- [Create and Activate a Subscription](https://docs.therius.io/api-reference/subscriptions/create.md): Enroll a customer in a plan and charge the first billing cycle. Performs the initial CIT that registers the recurring mandate.
- [List and Filter Subscriptions](https://docs.therius.io/api-reference/subscriptions/list.md): Retrieve a paginated list of subscriptions with filters for status, email, plan, card brand, and creation date range.
- [Retrieve Subscription Details](https://docs.therius.io/api-reference/subscriptions/get.md): Retrieve full details for a subscription by its UUID, including its plan and current dunning progress.
- [Cancel a Subscription](https://docs.therius.io/api-reference/subscriptions/cancel.md): Immediately cancel a subscription. Fires the subscription.cancelled webhook event. Cannot be undone.
- [Pause and Resume a Subscription](https://docs.therius.io/api-reference/subscriptions/pause-resume.md): Pause a subscription to stop billing temporarily without cancelling it. Resume billing from a paused or suspended state with a single API call.
- [Upgrade or Downgrade a Subscription](https://docs.therius.io/api-reference/subscriptions/change-plan.md): Move a subscriber to a different plan immediately (with proration) or at next billing cycle.
- [Update a Subscription's Payment Method](https://docs.therius.io/api-reference/subscriptions/update-payment-method.md): Replace the card on a subscription. Changing the card is a CIT and may need 3D Secure — record a card you already CIT'd, or run a zero-value CIT here.
- [List and Retrieve Subscription Invoices](https://docs.therius.io/api-reference/subscriptions/invoices.md): List invoices for a subscription or retrieve a single invoice by its UUID.
- [Record Metered Usage](https://docs.therius.io/api-reference/subscriptions/usage.md): Report a usage event against a subscription so metered charges are added to the next invoice.

### Subscription Plans

- [Create a Subscription Plan](https://docs.therius.io/api-reference/plans/create.md): Define a recurring billing plan with amount, currency, interval, trial period, and optional geographic restrictions.
- [List All Subscription Plans](https://docs.therius.io/api-reference/plans/list.md): List all billing plans for your merchant account, with optional country filter. Includes subscriber count and archive state.
- [Update a Subscription Plan](https://docs.therius.io/api-reference/plans/update.md): Update a plan name, description, active status, or country availability. Amount and interval cannot be changed.
- [Archive a Subscription Plan](https://docs.therius.io/api-reference/plans/archive.md): Soft-archive a plan so no new subscriptions can enroll. Existing subscribers continue until their next renewal.

### SDK Session

- [Create a Short-Lived SDK Token](https://docs.therius.io/api-reference/sdk-session.md): Exchange your private API key for a short-lived client token to initialize the Therius JS SDK in the browser safely.

## JS SDK

### Overview

- [Therius JS SDK Overview: Browser Payment Integration](https://docs.therius.io/sdk/overview.md): The Therius JS SDK collects card data in hosted iframes so raw card numbers never touch your server. Supports hosted fields, wallet buttons, and APMs.
- [SDK Session Bootstrap: Exchange Key for Client Token](https://docs.therius.io/sdk/session-bootstrap.md): Create a short-lived JWT client token by calling POST /sdk/session from your server. Pass the token to the browser to initialize the Therius JS SDK.

### Card Collection

- [Hosted Fields: Custom PCI-Safe Card Form Integration](https://docs.therius.io/sdk/hosted-fields.md): Use Therius hosted fields to render card inputs inside iframes your page controls. Get a one-time nonce to charge on your server — no PAN in your DOM.
- [Checkout Widget: Drop-In PCI-Safe Payment Form Setup](https://docs.therius.io/sdk/checkout-widget.md): Embed the Therius Checkout Widget for a ready-made card form with saved-card support. Drop it in with two lines of code — no form building required.
- [Saved Cards: Returning Shopper One-Click Checkout Flow](https://docs.therius.io/sdk/saved-cards.md): Let returning shoppers pay with a saved card. Set customerId on the SDK session to enable the vault picker and charge saved tokens without re-entry.

### Wallets & More

- [Wallet Buttons: Apple Pay and Google Pay Integration](https://docs.therius.io/sdk/wallet-buttons.md): Add Apple Pay and Google Pay with the Therius SDK createWalletButton helper. The native payment sheet handles authentication and card selection for you.
- [Click to Pay: Visa and Mastercard Network Saved Cards](https://docs.therius.io/sdk/click-to-pay.md): Add Click to Pay to your checkout with the Therius SDK. Supports Visa and Mastercard network-level saved cards via CyberSource with no card re-entry.
- [APM Redirects: iDEAL, Klarna, and Pix with the SDK](https://docs.therius.io/sdk/apm-redirects.md): Use sdk.purchaseApm and sdk.handleAction to process redirect-based APMs like Pix, iDEAL, and Klarna with automatic redirect handling and result resolution.

## Connections

### Payment Methods

- [Therius Payment Methods: 40+ Options, One Endpoint](https://docs.therius.io/connections/overview.md): Every payment method Therius supports routes through POST /payment/purchase. Browse by category or find a specific method for a code example.
- [Cards and Digital Wallets: Accepted Payment Methods](https://docs.therius.io/connections/cards-wallets.md): Accept credit and debit cards, Apple Pay, Google Pay, Click to Pay, PayPal, Alipay, GrabPay, and more digital wallets through the Therius payment API.
- [Bank Transfers and Direct Debit Payment Methods Guide](https://docs.therius.io/connections/bank-transfers.md): Accept Pix, ACH, SEPA, iDEAL, BLIK, Przelewy24, EPS, Multibanco, SPEI, PSE, and other bank transfer methods through the Therius payment API.
- [Voucher and Cash Payment Methods: Boleto, OXXO, Konbini](https://docs.therius.io/connections/vouchers-cash.md): Accept cash voucher payments with Boleto (Brazil), OXXO (Mexico), and Konbini (Japan) through the Therius API. These methods settle asynchronously.
- [Buy Now, Pay Later Methods: Klarna, Afterpay, and More](https://docs.therius.io/connections/buy-now-pay-later.md): Offer Klarna, Afterpay, Affirm, and Zip installment and deferred payment options through the Therius payment API. No extra integration required.
- [Asia-Pacific Local Payment Methods: UPI, QRIS, and More](https://docs.therius.io/connections/apac-methods.md): Accept UPI (India), QRIS (Indonesia), FPX (Malaysia), PayNow (Singapore), PromptPay (Thailand), and GrabPay across Southeast Asia via Therius.
- [Latin America Local Payment Methods: Efecty and More](https://docs.therius.io/connections/latam-methods.md): Accept Efecty, Rapipago, PagoFácil, PagoEfectivo, Nequi, Yape, Khipu, Transbank Debit, and other LATAM payment methods through the Therius payment API.

## OpenAPI Specs

- [openapi](/openapi.json)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [Spanish (65 pages)](https://docs.therius.io/_llms/es.md): Documentation for Spanish.
- [Portuguese (65 pages)](https://docs.therius.io/_llms/pt.md): Documentation for Portuguese.