Changelog

​

Features

• Support cases: Customers can now open support tickets on their completed orders directly from the Pandabase portal. Merchants get real-time email notifications and can reply from their dashboard.
• Pandabase support intervention: When a case needs platform oversight, our team can join the conversation. Staff replies are visible to both parties and clearly branded as Pandabase Support — no back-channels.
• Attachments: Up to 5 files per message, allowlist (image/*, application/pdf, text/plain, application/zip). All URLs are short-lived.
• Customer emails now route through the portal: Payment, order, subscription, and refund emails to customers no longer link to external support addresses — they direct users to sign in at mypandabase.com and open a ticket against the relevant order.

​

Features

• 5 new merchant countries: Pandabase is now available to merchants in Israel, Romania, Hong Kong, Philippines, and Morocco — bringing total coverage to 43 countries.

​

Features

• available_payment_methods in checkout estimate: The POST /v2/stores/:storeId/checkouts/estimate endpoint now returns a list of supported payment methods based on the customer’s country, alongside the existing presentment currency resolution. Global methods (Card, Apple Pay, Google Pay) are always included, with country-specific methods added on top:
  • US: Cash App, Amazon Pay, WeChat Pay, Alipay
  • UK: Cash App, Amazon Pay (plus EU methods)
  • EU/EEA (Eurozone, Czechia, Denmark, Hungary, Poland, Sweden, Norway, Switzerland): iDEAL/Wero, Bancontact, Multibanco, MB WAY, EPS, Przelewy24, BLIK, Amazon Pay
  • Brazil: PIX
  • India: UPI
  • South Korea: Naver Pay, Kakao Pay, PAYCO, Samsung Pay

​

Features

• 9 new supported countries: Pandabase is now available to merchants in Australia, New Zealand, India, United Arab Emirates, Qatar, Taiwan, Vietnam, Thailand, and Switzerland. Local bank transfers are supported for Australia (BECS), New Zealand, India (NEFT/IMPS), Thailand, and Switzerland (SEPA). Wire (SWIFT) payouts are available for Thailand, Vietnam, United Arab Emirates, Qatar, and Taiwan.

​

Features

• Inclusive tax support: Stores can now set their tax behavior to INCLUSIVE via store settings. When enabled, product prices are treated as tax-inclusive and the tax portion is back-calculated for invoices and accounting. Configure via PATCH /v2/stores/:storeId with taxBehavior: "INCLUSIVE".
• Async payment method support: Payments via ACH, SEPA, and other bank transfer methods now show a PROCESSING status while the payment clears. Customers receive an email confirming their payment is in progress.
• Coupon customer restrictions enforced: firstPurchaseOnly and maxUsesPerCustomer coupon settings are now validated at checkout. Previously these were stored but not enforced.
• Max coupons per store: Increased from 100 to 1,000.

​

Fixes

• Checkout now rejects email addresses in the customer name field.

​

Features

• Product-scoped coupons: Coupons can now be restricted to specific products. When a coupon has products assigned, the discount only applies to those items in the cart. Coupons without product scoping continue to apply to the entire cart.
  • Set productIds when creating or updating a coupon to scope it to specific products.
  • Pass null or an empty array to remove the product scope.
  • Available via the dashboard, Store API, and all coupon endpoints.

​

Features

• Recurring billing: Merchants can now sell subscription products with automatic recurring charges. Supports weekly, monthly, and yearly billing intervals.
• Free trials: Subscription products can offer a free trial period. Customers save their card during checkout and are charged automatically when the trial ends.
• Subscription management: New endpoints to list, view, cancel, pause, and resume subscriptions. Available via the dashboard, Store API, and customer portal.
  • GET /v2/stores/:storeId/subscriptions
  • GET /v2/stores/:storeId/subscriptions/:subscriptionId
  • POST /v2/stores/:storeId/subscriptions/:subscriptionId/cancel
  • POST /v2/stores/:storeId/subscriptions/:subscriptionId/pause
  • POST /v2/stores/:storeId/subscriptions/:subscriptionId/resume
• Customer portal subscriptions: Customers can view and cancel their subscriptions across all stores from the customer portal at mypandabase.com.
• Subscription invoices: Customers receive a PDF invoice via email on every successful renewal charge.
• 3D Secure on renewals: When a renewal payment requires additional authentication, customers receive an email with a secure link to verify the payment.
• Subscription webhooks: Six new webhook events — SUBSCRIPTION_CREATED, SUBSCRIPTION_RENEWED, SUBSCRIPTION_PAST_DUE, SUBSCRIPTION_CANCELLED, SUBSCRIPTION_PAUSED, SUBSCRIPTION_RESUMED.
• Store API support: Subscription endpoints available via token-authenticated Store API with SUBSCRIPTIONS_READ and SUBSCRIPTIONS_WRITE permissions.
• Merchant dashboard: Full subscription management UI with list view, detail page, and pause/resume/cancel actions.

​

Features

• Checkout title & description: Customize the heading and description shown on the checkout page. Title defaults to your store name. Description is only shown when explicitly set.
• Store questionnaire: New onboarding questionnaire for stores. Required before accepting payments — collects business type, description, country, and expected volume. Companies and nonprofits also provide legal entity name, tax ID, and registered address.
• Localized payment toggle: Merchants can now enable or disable local currency payments per store via PATCH /v2/stores/:storeId.
• Improved payout error messages: Payout requests now show a detailed breakdown when balance is insufficient, including the total needed and fee breakdown.
• Receipt support email: Order receipt emails now show the merchant’s support email instead of a generic address.
• Max stores increased: Accounts can now create up to 10 stores (previously 3).

​

Features

• Local currency payments: Customers are now charged in their local currency when checking out from a supported country. This enables payment methods like PIX, iDEAL, SEPA Debit, Bancontact, Naver Pay, Kakao Pay, and more. Settlements remain in USD.
• Balance ledger: New GET /v2/stores/:storeId/payouts/ledger endpoint for a full audit trail of balance changes — payments, refunds, disputes, and payouts.
• Presentment data on orders: Order and payment responses now include presentmentCurrency, presentmentAmount, and exchangeRate when a local currency was used.

​

Features

• New payout countries: Added Canada, Singapore, Turkiye, Hungary, Sweden, Denmark, and Norway.
• SWIFT transfers: Merchants in countries without local rail support can now receive payouts via SWIFT.
• Country-specific bank accounts: Sort codes (GB), transit/institution numbers (CA), bank/branch codes (SG), SWIFT/BIC codes (TR), and IBAN (EU/EEA).
• Bank account verification: UK bank accounts are now verified against the bank’s records before being accepted.
• Payout emails: Merchants now receive an email when a payout is requested with estimated processing timeline.

​

Fixes

• Platform fee adjusted from 6% to 5.9% per transaction.

​

Features

• Early fraud protection: Payments flagged with early fraud warnings are now automatically refunded for low-value orders or flagged for manual review. Merchants are notified via email.
• Dispute status tracking: Disputes now transition to UNDER_REVIEW when evidence is submitted to the card network.
• Team notifications: All team actions (add, remove, role update) now send email notifications to both the affected member and the store owner.
• Role update notifications: Changing a team member’s role now sends a notification showing the previous and new role with permission details.
• Improved order timeline: Added fulfillment started and payment failed events to the order timeline.
• Partial customer prefill: Create checkout sessions with just name and email — billing address can be added later via PATCH. Tax is calculated once billing is provided.
• Lower item minimums: Dynamic checkout items can now be as low as $0.01 per unit. The total checkout amount must still be at least$1.00.
• Storefront store resolution: New GET /v2/storefront/resolve/:handle endpoint to look up a store by its handle — useful for subdomain-based routing.
• Storefront product by handle: New GET /v2/storefront/stores/:storeId/products/by-handle/:handle endpoint to fetch a product by its URL-friendly handle.

​

Fixes

• Fixed refund response returning incorrect amount.
• Fixed dispute won incorrectly restoring the non-refundable dispute fee to merchant balance.
• Fixed coupon usage not rolling back when refunds are initiated externally.
• Fixed refund confirmation emails not being sent on certain refund paths.
• Total minimum is now enforced unconditionally on all checkout endpoints (estimate, create, update). Previously, the check was skipped when no billing address was provided.
• Fixed storefront routes returning 500 errors instead of proper JSON error responses.
• Fixed storefront resolve endpoint failing when storeId was not present in the URL.

​

Features

• Checkout metadata: Attach arbitrary key-value string pairs (metadata) when creating checkout sessions. Metadata flows through orders, webhook payloads, and fulfillment webhooks. Max 20 keys, key max 40 chars, value max 500 chars.
• Product soft delete: Products are now soft-deleted via deleted_at field. Soft-deleted products are excluded from storefront listings, checkout item resolution, and all product queries. Order history is preserved.

​

Fixes

• Fixed deleted products still appearing in checkout item resolution.
• Added GB (United Kingdom) as a supported merchant country.

​

V2 API

• New response format: { ok: true, data } / { ok: false, error }
• New pagination format: { items, pagination: { page, limit, total, totalPages } }
• Stricter request validation with better error messages
• Magic link authentication (no passwords)
• All monetary values in cents (integers, no floats)

​

New Modules

• Checkouts: Stateful checkout sessions with custom fields (text, numeric, dropdown), coupon/tax support, and pay-what-you-want pricing
• Storefront: Public read-only API for store info, products (with variants/options), and categories — no authentication required
• Store API: Token-authenticated programmatic API with granular permissions (Bearer or HMAC authentication)
• Licenses: Encrypted license key management with verification endpoint and activation tracking
• API Logs: Request audit logging with 30-day retention for Store API requests
• Customers: Read-only customer management (customers created automatically during checkout)

​

New Webhook Events

​

New Webhook Payload

​

Products

• Variants with options, slug, description, SKU, stock tracking, and positioning
• Product options (e.g. Size, Color) with values array
• Fulfillment modes: MANAGED_LICENSE, LICENSE_POOL, LICENSE_WEBHOOK, INSTANT_DOWNLOAD, REDIRECT, MANUAL
• Pricing models: STANDARD, PAY_WHAT_YOU_WANT, FREE
• Product status: DRAFT / ACTIVE
• Availability windows (available_from, available_until)
• Max per customer limits
• Unique handles per store (auto-generated from title)

​

Orders

• Timeline events for full payment/refund/dispute/fulfillment audit trail
• Dispute evidence submission with auto-filled MoR data
• Fulfillment retry for failed webhook deliveries
• Order receipts with license key delivery via email

​

Payouts

• Bank account management via global payouts
• Payout requests with minimum $5 threshold
• Safe concurrent payout processing

​

Teams

• Role-based access control: VIEWER, MODERATOR, DEVELOPER, ADMINSTRATOR
• Team member CRUD (admin only)

​

Authentication

• Magic link auth (passwordless) with 10-minute TTL
• Session management with IP binding, device/browser/OS tracking
• TOTP-based 2FA
• Phone verification via Twilio
• KYC verification via SumSub

​

Supported Countries

​

Deprecations

• V1 API endpoints are deprecated and will be removed on April 1st, 2026
• V1 webhook event format (payment.success, payment.paid, etc.) replaced by V2 uppercase events
• V1 Transaction model replaced by InboundPayment in V2
• V1 Recipient and Payout models replaced by OutboundPayoutMethod and OutboundPayout

​

Features

• Added support for applying coupons during checkout.
• Introduced support for additional currencies (EUR, GBP).
• Added guest and authenticated customer management.
• Improved session management and user lifecycle handling.

​

Fixes

• Resolved issues with file validation during uploads.
• Improved category and slug validations.
• Fixed bugs in session retrieval and pagination.

​

New Properties

• tax_calculation_enabled, localized_pricing_enabled, regional_pricing_enabled on shop flags
• checkout_collect_phone_enabled, checkout_verify_email_enabled on shop flags
• images[] and categories[] on product objects
• icon_url on shop objects

​

Pagination

​

Filtering and Sorting

​

New Features

• MoR Model: Pandabase as Merchant of Record.
• Advanced Analytics: Store analytics endpoints.
• Dynamic Payments: Custom fields during checkout.
• Idempotency: Support for POST, PUT, and PATCH requests.
• File API: Intent-based file uploads at /files.

• Added /public endpoints with filtering support.
• Added /onboarding and /login endpoints.
• Added flags to shops.

• Added /categories route with full CRUD support.
• Added categories field to product model.

• Added payout and recipients routes.
• Added KYC verification support.
• Added customer auth tokens.

• Renamed transaction event types to order.
• Added payment.pending, payment.paid, payment.success, payment.failed event types.

• Added analytics properties to shop objects (total_sales, total_earned, pending_balance, dispute_rate).
• Added feature flags (pmp_enabled, chargeback_protection_enabled, storefront_enabled, etc.).
• Added fee and early_fraud_warning to transaction objects.
• Added discounted and discount_code to order objects.
• Added reason and status to refund and dispute objects.

• Initial V1 API release with stores, products, orders, coupons, webhooks, and payments.
• Sort and filter support for List Orders route.