# Pandabase

> The merchant of record platform for digital commerce.

## Docs

- [What is Pandabase?](/.md): Welcome to Pandabase — the merchant of record platform for digital commerce.
- [Start selling](/quickstart.md): Start selling digital products within minutes of signing up.
- [Pricing](/pricing.md): Transparent, pay-as-you-go pricing with no monthly fees or hidden charges.
- [Managing your Account](/account.md): Setting up your account, identity verification, and security.
- [Payment lifecycle](/developers/learn/lifecycle.md): How orders, payments, refunds, and disputes flow through Pandabase, and which webhook events fire at each step.
- [Dynamic Payments](/developers/learn/dynamic-payments.md): Collect additional information from customers during checkout using custom fields and metadata.
- [Hosted Checkout](/developers/learn/hosted-checkout.md): Embed or redirect to Pandabase's hosted checkout page.
- [Subscriptions](/developers/learn/subscriptions.md): Accept recurring payments with automatic billing, trials, and lifecycle management.
- [Usage-based billing](/developers/learn/usage-based-billing.md): Charge subscription customers for what they actually use, with metered events, flexible aggregation, and per-unit pricing.
- [Reports](/developers/learn/reports.md): Generate async CSV and JSON exports of financial activity via the Reports API.
- [API Tokens](/developers/learn/api-tokens.md): Authenticate with the Store API using Bearer tokens or HMAC signatures.
- [Storefront API](/developers/learn/storefront-api.md): Public read-only API for displaying store information, products, and categories on your frontend.
- [Getting Started](/developers/websdk/getting-started.md): Low-level browser SDK for building custom checkout experiences.
- [Overview](/developers/webhooks/overview.md): Listen for store events and trigger actions in your application.
- [Events](/developers/webhooks/events.md): Reference for every event Pandabase can send to your webhook endpoints.
- [Migrate webhook signatures](/developers/webhooks/migrate-signatures.md): Upgrade to Standard Webhooks v2 before V1 is deprecated.
- [TypeScript](/developers/sdks/typescript.md): Use our TypeScript SDK to interact with our API.
- [Go](/developers/sdks/go.md): Use our Go SDK to interact with our API.
- [Quickstart](/developers/connected-accounts/quickstart.md): Onboard connected accounts and start accepting payments on your platform.
- [Changelog](/developers/changelog.md): Keep track of every change to the Pandabase API.
- [Introduction](/developers/api/introduction.md): Learn how to use the Pandabase API programmatically.
- [Pagination](/developers/api/pagination.md): Learn how pagination works across the Pandabase API.
- [Rate limits](/developers/api/rate-limits.md): Learn about API rate limits and how to work with them.
- [Response Format](/developers/api/responses.md): Learn how the Pandabase API structures responses and handles errors.
- [Get store](/developers/api/store-api-reference/store/get-stores-storeid.md): Returns the public configuration of the store. Requires the `STORE_READ` scope.
- [List products](/developers/api/store-api-reference/products/get-stores-storeid-products.md): Returns a list of products on the store. Soft-deleted products are excluded. Requires the `PRODUCTS_READ` scope.
- [Create product](/developers/api/store-api-reference/products/post-stores-storeid-products.md): Creates a new product on the store. Subscription products require a billing interval. Requires the `PRODUCTS_WRITE` scope.
- [Get product](/developers/api/store-api-reference/products/get-stores-storeid-products-productid.md): Retrieves a product by ID. Requires the `PRODUCTS_READ` scope.
- [Update product](/developers/api/store-api-reference/products/patch-stores-storeid-products-productid.md): Updates an existing product. Variants and options on the request are upserted by ID. Requires the `PRODUCTS_WRITE` scope.
- [Delete product](/developers/api/store-api-reference/products/delete-stores-storeid-products-productid.md): Soft-deletes a product so it can no longer be purchased. Existing order line items remain intact for historical reference. Requires the `PRODUCTS_WRITE` scope.
- [List categories](/developers/api/store-api-reference/categories/get-stores-storeid-categories.md): Returns a list of product categories on the store. Requires the `CATEGORIES_READ` scope.
- [Create category](/developers/api/store-api-reference/categories/post-stores-storeid-categories.md): Creates a new product category. Requires the `CATEGORIES_WRITE` scope.
- [Get category](/developers/api/store-api-reference/categories/get-stores-storeid-categories-categoryid.md): Retrieves a product category by ID. Requires the `CATEGORIES_READ` scope.
- [Update category](/developers/api/store-api-reference/categories/patch-stores-storeid-categories-categoryid.md): Updates an existing product category. Requires the `CATEGORIES_WRITE` scope.
- [Delete category](/developers/api/store-api-reference/categories/delete-stores-storeid-categories-categoryid.md): Deletes a product category. Products previously assigned to the category remain on the store. Requires the `CATEGORIES_WRITE` scope.
- [List coupons](/developers/api/store-api-reference/coupons/get-stores-storeid-coupons.md): Returns a list of coupons on the store. Requires the `COUPONS_READ` scope.
- [Create coupon](/developers/api/store-api-reference/coupons/post-stores-storeid-coupons.md): Creates a coupon that can be redeemed at checkout. Requires the `COUPONS_WRITE` scope.
- [Get coupon](/developers/api/store-api-reference/coupons/get-stores-storeid-coupons-couponid.md): Retrieves a coupon by ID. Requires the `COUPONS_READ` scope.
- [Update coupon](/developers/api/store-api-reference/coupons/patch-stores-storeid-coupons-couponid.md): Updates an existing coupon. The redemption code itself is immutable. Requires the `COUPONS_WRITE` scope.
- [Delete coupon](/developers/api/store-api-reference/coupons/delete-stores-storeid-coupons-couponid.md): Deletes a coupon. Existing orders that redeemed it are unaffected. Requires the `COUPONS_WRITE` scope.
- [List webhooks](/developers/api/store-api-reference/webhooks/get-stores-storeid-webhooks.md): Returns a list of webhook endpoints configured on the store. Requires the `WEBHOOKS_READ` scope.
- [Create webhook](/developers/api/store-api-reference/webhooks/post-stores-storeid-webhooks.md): Creates a new webhook endpoint. The secret is returned only on creation and cannot be retrieved later. Requires the `WEBHOOKS_WRITE` scope.
- [Get webhook](/developers/api/store-api-reference/webhooks/get-stores-storeid-webhooks-webhookid.md): Retrieves a webhook endpoint by ID. Requires the `WEBHOOKS_READ` scope.
- [Update webhook](/developers/api/store-api-reference/webhooks/patch-stores-storeid-webhooks-webhookid.md): Updates an existing webhook endpoint. Requires the `WEBHOOKS_WRITE` scope.
- [Delete webhook](/developers/api/store-api-reference/webhooks/delete-stores-storeid-webhooks-webhookid.md): Deletes a webhook endpoint. Past deliveries are retained for 30 days. Requires the `WEBHOOKS_WRITE` scope.
- [Get analytics overview](/developers/api/store-api-reference/analytics/get-stores-storeid-analytics-overview.md): Returns aggregate metrics for the store across orders, revenue, customers, and refunds. Requires the `ANALYTICS_READ` scope.
- [Get gross volume](/developers/api/store-api-reference/analytics/get-stores-storeid-analytics-gross-volume.md): Returns gross transaction volume bucketed over the requested time range. Requires the `ANALYTICS_READ` scope.
- [Get orders by country](/developers/api/store-api-reference/analytics/get-stores-storeid-analytics-orders-by-country.md): Returns order counts grouped by customer country. Requires the `ANALYTICS_READ` scope.
- [List payouts](/developers/api/store-api-reference/payouts/get-stores-storeid-payouts.md): Returns a list of payouts requested by the store, most recent first. Requires the `PAYOUTS_READ` scope.
- [Get payout](/developers/api/store-api-reference/payouts/get-stores-storeid-payouts-payoutid.md): Retrieves a payout by ID. The response includes the trace ID and expected delivery date once the payout has been dispatched. Requires the `PAYOUTS_READ` scope.
- [List bank accounts](/developers/api/store-api-reference/payouts/get-stores-storeid-payouts-bank-accounts.md): Returns the bank accounts configured for the store's payouts. Requires the `PAYOUTS_READ` scope.
- [List balance ledger](/developers/api/store-api-reference/payouts/get-stores-storeid-payouts-ledger.md): Returns the store's balance ledger, an immutable record of every balance mutation. Requires the `PAYOUTS_READ` scope.
- [List orders](/developers/api/store-api-reference/orders/get-stores-storeid-orders.md): Returns a list of orders placed on the store, most recent first. Requires the `ORDERS_READ` scope.
- [Get order](/developers/api/store-api-reference/orders/get-stores-storeid-orders-orderid.md): Retrieves an order by ID. Requires the `ORDERS_READ` scope.
- [List order refunds](/developers/api/store-api-reference/orders/get-stores-storeid-orders-orderid-refunds.md): Returns the refunds issued against the specified order. Requires the `ORDERS_READ` scope.
- [Retry order fulfillment](/developers/api/store-api-reference/orders/post-stores-storeid-orders-orderid-retry-fulfillment.md): Re-runs fulfillment for an order whose initial fulfillment attempt failed. Requires the `ORDERS_WRITE` scope.
- [List payments](/developers/api/store-api-reference/payments/get-stores-storeid-orders-payments.md): Returns a list of payments collected on the store, most recent first. Requires the `ORDERS_READ` scope.
- [Get payment](/developers/api/store-api-reference/payments/get-stores-storeid-orders-payments-paymentid.md): Retrieves a payment by ID. Requires the `ORDERS_READ` scope.
- [List customers](/developers/api/store-api-reference/customers/get-stores-storeid-customers.md): Returns a list of customers who have checked out on the store, most recent first. Requires the `CUSTOMERS_READ` scope.
- [Get customer](/developers/api/store-api-reference/customers/get-stores-storeid-customers-customerid.md): Retrieves a customer by ID. Requires the `CUSTOMERS_READ` scope.
- [List licenses](/developers/api/store-api-reference/licenses/get-stores-storeid-licenses.md): Returns a list of license keys issued by the store. Requires the `LICENSES_READ` scope.
- [Get license](/developers/api/store-api-reference/licenses/get-stores-storeid-licenses-licenseid.md): Retrieves a license by ID. The response includes the decrypted key. Requires the `LICENSES_READ` scope.
- [Verify license](/developers/api/store-api-reference/licenses/post-stores-storeid-licenses-verify.md): Verifies a license key against a product and returns its activation status. Intended for first-party software activation flows. Requires the `LICENSES_READ` scope.
- [List subscriptions](/developers/api/store-api-reference/subscriptions/get-stores-storeid-subscriptions.md): Returns a list of subscriptions on the store, most recent first. Requires the `SUBSCRIPTIONS_READ` scope.
- [Get subscription](/developers/api/store-api-reference/subscriptions/get-stores-storeid-subscriptions-subscriptionid.md): Retrieves a subscription by ID. Requires the `SUBSCRIPTIONS_READ` scope.
- [Get subscription usage](/developers/api/store-api-reference/subscriptions/get-stores-storeid-subscriptions-subscriptionid-usage.md): Returns a live projection of the current billing period together with summaries of past periods for the subscription. Non-usage subscriptions return `isUsageBased: false`. Requires the `USAGE_READ` scope.
- [Get upcoming invoice](/developers/api/store-api-reference/subscriptions/get-stores-storeid-subscriptions-subscriptionid-upcoming-invoice.md): Previews the next charge for a subscription — base + projected usage + MoR tax — matching what the renewal will bill. Requires the `SUBSCRIPTIONS_READ` scope.
- [Cancel subscription](/developers/api/store-api-reference/subscriptions/post-stores-storeid-subscriptions-subscriptionid-cancel.md): Cancels a subscription, either at once or at the end of the current billing period depending on the `cancelAt` value. Requires the `SUBSCRIPTIONS_WRITE` scope.
- [Pause subscription](/developers/api/store-api-reference/subscriptions/post-stores-storeid-subscriptions-subscriptionid-pause.md): Pauses billing on an active subscription. Requires the `SUBSCRIPTIONS_WRITE` scope.
- [Resume subscription](/developers/api/store-api-reference/subscriptions/post-stores-storeid-subscriptions-subscriptionid-resume.md): Resumes a paused subscription. Requires the `SUBSCRIPTIONS_WRITE` scope.
- [Change subscription plan](/developers/api/store-api-reference/subscriptions/post-stores-storeid-subscriptions-subscriptionid-change.md): Upgrades, downgrades, or re-prices a subscription (product, variant, interval, or quantity). Upgrades charge a prorated difference immediately; downgrades and end-of-period changes apply at the next renewal. Requires the `SUBSCRIPTIONS_WRITE` scope.
- [Reactivate subscription](/developers/api/store-api-reference/subscriptions/post-stores-storeid-subscriptions-subscriptionid-reactivate.md): Clears a pending cancellation on a subscription still within its current period. Requires the `SUBSCRIPTIONS_WRITE` scope.
- [List cases](/developers/api/store-api-reference/cases/get-stores-storeid-cases.md): Returns a list of support cases on the store, most recent first. Requires the `CASES_READ` scope.
- [Get case](/developers/api/store-api-reference/cases/get-stores-storeid-cases-caseid.md): Retrieves a support case by ID. Requires the `CASES_READ` scope.
- [Update case](/developers/api/store-api-reference/cases/patch-stores-storeid-cases-caseid.md): Updates a support case, typically to change its status. Requires the `CASES_WRITE` scope.
- [List case messages](/developers/api/store-api-reference/cases/get-stores-storeid-cases-caseid-messages.md): Returns the messages on a support case in chronological order. Requires the `CASES_READ` scope.
- [Send case message](/developers/api/store-api-reference/cases/post-stores-storeid-cases-caseid-messages.md): Posts a reply to a support case. The customer is notified by email. Requires the `CASES_WRITE` scope.
- [Mark case as read](/developers/api/store-api-reference/cases/post-stores-storeid-cases-caseid-read.md): Marks all unread customer messages on a case as read. Requires the `CASES_WRITE` scope.
- [List refunds](/developers/api/store-api-reference/refunds/get-stores-storeid-refunds.md): Returns a list of refunds issued on the store, most recent first. Requires the `REFUNDS_READ` scope.
- [Get refund](/developers/api/store-api-reference/refunds/get-stores-storeid-refunds-refundid.md): Retrieves a refund by ID. Requires the `REFUNDS_READ` scope.
- [Create refund](/developers/api/store-api-reference/refunds/post-stores-storeid-refunds-orders-orderid.md): Issues a refund against an order. The order must be completed, have no open dispute, and fall within the 30-day refund window. Requires the `REFUNDS_WRITE` scope.
- [List disputes](/developers/api/store-api-reference/disputes/get-stores-storeid-disputes.md): Returns a list of disputes filed against the store's payments. Requires the `DISPUTES_READ` scope.
- [Get dispute](/developers/api/store-api-reference/disputes/get-stores-storeid-disputes-disputeid.md): Retrieves a dispute by ID. Requires the `DISPUTES_READ` scope.
- [Submit dispute evidence](/developers/api/store-api-reference/disputes/post-stores-storeid-disputes-disputeid-evidence.md): Submits evidence for a dispute to be reviewed by the card network. Customer-side fields are auto-filled from the original transaction. Requires the `DISPUTES_WRITE` scope.
- [List usage events](/developers/api/store-api-reference/usage/get-stores-storeid-usage.md): Returns a list of usage events for a subscription, most recent first. Can be filtered by `meter_id` and by an `event_at` range. Requires the `USAGE_READ` scope.
- [Report usage events](/developers/api/store-api-reference/usage/post-stores-storeid-usage.md): Reports usage events against a subscription's meters. Up to 100 events may be reported per call. Duplicate events keyed by `meter_id` and `external_id` are silently skipped. Requires the `USAGE_WRITE` scope.
- [List meters](/developers/api/store-api-reference/meters/get-stores-storeid-products-productid-meters.md): Returns the list of usage meters configured on a product. Requires the `METERS_READ` scope.
- [Create meter](/developers/api/store-api-reference/meters/post-stores-storeid-products-productid-meters.md): Creates a usage meter on a product. The product must be a subscription with `pricing_model` set to `USAGE_BASED`. A product can have up to 10 meters. Requires the `METERS_WRITE` scope.
- [Get meter](/developers/api/store-api-reference/meters/get-stores-storeid-products-productid-meters-meterid.md): Retrieves a usage meter by ID. Requires the `METERS_READ` scope.
- [Update meter](/developers/api/store-api-reference/meters/patch-stores-storeid-products-productid-meters-meterid.md): Updates a usage meter. The `eventName`, `aggregation`, and `settlement` fields become immutable once any usage event has been reported against the meter. Rate fields remain editable. Requires the `METERS_WRITE` scope.
- [Delete meter](/developers/api/store-api-reference/meters/delete-stores-storeid-products-productid-meters-meterid.md): Deletes a usage meter. Returns a `409` if any usage event or billed period summary references the meter, since audit history is preserved indefinitely. Requires the `METERS_WRITE` scope.
- [List reports](/developers/api/store-api-reference/reports/get-stores-storeid-reports.md): Returns the store's reports, most recent first. Filter by `status` or `type`. Requires the `REPORTS_READ` scope.
- [Create report](/developers/api/store-api-reference/reports/post-stores-storeid-reports.md): Queues an asynchronous report. The response returns immediately with `status: PENDING`; poll `GET /reports/:reportId` or wait for the merchant email. Periods cannot exceed 90 days. Requires the `REPORTS_WRITE` scope.
- [Get report](/developers/api/store-api-reference/reports/get-stores-storeid-reports-reportid.md): Retrieves a report by ID. Status transitions: `PENDING → PROCESSING → SUCCEEDED | FAILED`. Requires the `REPORTS_READ` scope.
- [Get download URL](/developers/api/store-api-reference/reports/get-stores-storeid-reports-reportid-download-format.md): Returns a 5-minute pre-signed S3 URL for the generated report file. Fetch a fresh URL when the previous one expires. Requires the `REPORTS_READ` scope.
- [Get store](/developers/api/storefront-api-reference/store/getstorefront.md): Returns public store information including branding, description, and social links.
- [List products](/developers/api/storefront-api-reference/products/liststorefrontproducts.md): Returns a paginated list of active products. Supports filtering, searching, and sorting. Only active products are returned — draft and deleted products are never included.
- [Get product](/developers/api/storefront-api-reference/products/getstorefrontproduct.md): Returns full product details including variants, options, and categories.
- [List categories](/developers/api/storefront-api-reference/categories/liststorefrontcategories.md): Returns a paginated list of categories. Supports filtering by featured status and parent category.
- [Get category](/developers/api/storefront-api-reference/categories/getstorefrontcategory.md): Returns category details including subcategories and up to 50 active products.
- [ProductType](/developers/api/storefront-api-reference/schemas/producttype.md): The ProductType object.
- [PricingModel](/developers/api/storefront-api-reference/schemas/pricingmodel.md): The PricingModel object.
- [Pagination](/developers/api/storefront-api-reference/schemas/pagination.md): The Pagination object.
- [CategoryRef](/developers/api/storefront-api-reference/schemas/categoryref.md): The CategoryRef object.
- [Storefront](/developers/api/storefront-api-reference/schemas/storefront.md): The Storefront object.
- [StorefrontProductListItem](/developers/api/storefront-api-reference/schemas/storefrontproductlistitem.md): The StorefrontProductListItem object.
- [StorefrontProduct](/developers/api/storefront-api-reference/schemas/storefrontproduct.md): The StorefrontProduct object.
- [StorefrontCategoryListItem](/developers/api/storefront-api-reference/schemas/storefrontcategorylistitem.md): The StorefrontCategoryListItem object.
- [StorefrontCategory](/developers/api/storefront-api-reference/schemas/storefrontcategory.md): The StorefrontCategory object.
- [Estimate checkout](/developers/api/billing-api-reference/checkouts/estimatecheckout.md): Stateless price estimation with tax and coupon preview. Does not create a session — use this to show a price breakdown before creating a checkout.
- [Create checkout session](/developers/api/billing-api-reference/checkouts/createcheckoutsession.md): Creates a checkout session with a 6-hour TTL. Returns a `checkout_url` that you can redirect customers to, or use the session ID to build a custom checkout experience. Supports both catalog products (by `product_id`) and dynamic line items (by `name` + `amount`).
- [CatalogItem](/developers/api/billing-api-reference/schemas/catalogitem.md): Reference an existing product from your catalog
- [DynamicItem](/developers/api/billing-api-reference/schemas/dynamicitem.md): A custom line item with a name and amount (not from your catalog)
- [Customer](/developers/api/billing-api-reference/schemas/customer.md): The Customer object.
- [BillingAddress](/developers/api/billing-api-reference/schemas/billingaddress.md): The BillingAddress object.
- [CustomFieldDefinition](/developers/api/billing-api-reference/schemas/customfielddefinition.md): The CustomFieldDefinition object.
- [EstimateCheckoutBody](/developers/api/billing-api-reference/schemas/estimatecheckoutbody.md): The EstimateCheckoutBody object.
- [CreateCheckoutBody](/developers/api/billing-api-reference/schemas/createcheckoutbody.md): The CreateCheckoutBody object.
- [Merchant](/developers/api/billing-api-reference/schemas/merchant.md): The Merchant object.
- [LineItem](/developers/api/billing-api-reference/schemas/lineitem.md): The LineItem object.
- [EstimateResponse](/developers/api/billing-api-reference/schemas/estimateresponse.md): The EstimateResponse object.
- [CheckoutSession](/developers/api/billing-api-reference/schemas/checkoutsession.md): The CheckoutSession object.
- [Analytics](/store/analytics.md): Track revenue, orders, refunds, and disputes across your store.
- [Payments](/store/manage-payments/payments.md): How payments work on Pandabase.
- [Refunds](/store/manage-payments/refunds.md): Issue refunds from your dashboard.
- [Disputes](/store/manage-payments/disputes.md): How chargebacks work and how to respond to them.
- [Fraud](/store/manage-payments/fraud.md): How Pandabase detects and blocks fraudulent payments before they reach your store.
- [Paylinks](/store/paylinks.md): Share a link, get paid. No code or storefront required.
- [Cases](/store/cases.md): Reply to customer support tickets opened against your orders.
- [Payouts](/store/finances/payouts.md): How payouts work, supported countries, and fees.
- [Bank accounts](/store/finances/bank-accounts.md): Connect bank accounts to receive payouts from your store.
- [Reports](/store/finances/reports.md): Export your store's financial activity as CSV or JSON for accounting, reconciliation, and bookkeeping.
- [Convert to an entity](/store/store-ownership/convert-to-entity.md): Move an individual-owned store under a registered company.
- [Delete a store](/store/store-ownership/delete-store.md): Close a store and what happens to its data afterwards.
- [Prohibited Businesses](/trust-and-safety/prohibited-businesses.md): What you can and can't sell on Pandabase, with concrete examples.