# Suby Documentation

## Docs

- [Find customer by email](https://documentation.suby.fi/api-reference/customers/find-customer-by-email.md)
- [Get customer by ID](https://documentation.suby.fi/api-reference/customers/get-customer-by-id.md)
- [List customers](https://documentation.suby.fi/api-reference/customers/list-customers.md): Paginated list of customers with at least one successful payment on your products.
- [Introduction](https://documentation.suby.fi/api-reference/introduction.md)
- [Create a one-time payment](https://documentation.suby.fi/api-reference/payments--checkout/create-a-one-time-payment.md): Creates a payment for a **one-time product** (`frequencyInDays` is `null`). Returns a checkout URL to redirect your customer to.
- [Get payment details](https://documentation.suby.fi/api-reference/payments--checkout/get-payment-details.md)
- [Initiate a payment (deprecated)](https://documentation.suby.fi/api-reference/payments--checkout/initiate-a-payment-deprecated.md): **Deprecated** — use `POST /api/payment/create` for one-time payments or `POST /api/subscription/create` for subscriptions.
- [List one-time payments](https://documentation.suby.fi/api-reference/payments--checkout/list-one-time-payments.md): Paginated list of payments on your **one-time products** only.
- [Create a product](https://documentation.suby.fi/api-reference/products/create-a-product.md): Creates a new product. Set `frequencyInDays` to define the billing cycle: - Omit or set to `null` → **one-time** product - Set to `30` → **monthly** subscription, `365` → yearly, etc.
- [Get product details](https://documentation.suby.fi/api-reference/products/get-product-details.md)
- [List products](https://documentation.suby.fi/api-reference/products/list-products.md): Paginated list of your products. Filter by status or platform.
- [Update a product](https://documentation.suby.fi/api-reference/products/update-a-product.md): Update product fields. All fields are optional.
- [Refund a card payment](https://documentation.suby.fi/api-reference/refunds/refund-a-card-payment.md): Refunds a card (fiat) payment. Only payments with status `PAYMENT_SUCCESS` or `CHECKOUT_SUCCESS` and source `FIAT` can be refunded. Crypto payments cannot be refunded from API.
- [Refund via payment route (deprecated)](https://documentation.suby.fi/api-reference/refunds/refund-via-payment-route-deprecated.md): **Deprecated** — use `POST /api/refund/{paymentId}` instead.
- [Cancel a subscription](https://documentation.suby.fi/api-reference/subscriptions--checkout/cancel-a-subscription.md): Cancels an active subscription. The customer loses access at the end of the current billing period.
- [Create a subscription payment](https://documentation.suby.fi/api-reference/subscriptions--checkout/create-a-subscription-payment.md): Creates a subscription payment for a **recurring product** (`frequencyInDays` is set). Returns a checkout URL to redirect your customer to.
- [Get subscription details](https://documentation.suby.fi/api-reference/subscriptions--checkout/get-subscription-details.md)
- [List subscriptions](https://documentation.suby.fi/api-reference/subscriptions--checkout/list-subscriptions.md): Paginated list of subscriptions on your recurring products.
- [How to Cancel a Subscription](https://documentation.suby.fi/docs/customers/how-to-cancel-a-subscription.md): Cancel your subscription at any time from the customer portal.
- [Why Did Suby Charge Me?](https://documentation.suby.fi/docs/customers/why-did-suby-charge-me.md): Understanding charges from Suby on your bank statement or card.
- [Analytics](https://documentation.suby.fi/docs/features/analytics.md): Track your revenue, customers, and growth from your dashboard.
- [Checkout](https://documentation.suby.fi/docs/features/checkout.md): The hosted checkout page Suby generates for every product.
- [Customers](https://documentation.suby.fi/docs/features/customers.md): View and manage your customers from the dashboard.
- [Discord Integration](https://documentation.suby.fi/docs/features/discord-integration.md): Sell access, gate roles, and manage your entire payment flow inside Discord.
- [Discount Codes](https://documentation.suby.fi/docs/features/discount-codes.md): Create fixed or percentage discounts with usage limits and expiry dates.
- [Fraud Prevention System ](https://documentation.suby.fi/docs/features/fraud-system.md): How Suby protects against automated attacks, card testing, and suspicious payment activity.
- [One-time Payments](https://documentation.suby.fi/docs/features/one-time-payments.md): Sell anything once. Digital products, services, or access, collected instantly.
- [PayLinks](https://documentation.suby.fi/docs/features/paylinks.md): A shareable checkout URL tied to a product. No code required.
- [Refunds](https://documentation.suby.fi/docs/features/refund.md): How to issue refunds from your dashboard.
- [Subscriptions](https://documentation.suby.fi/docs/features/subscriptions.md): Charge customers on a recurring basis. Suby handles renewals, failed payment recovery, and cancellations automatically.
- [Global Tax & Compliance](https://documentation.suby.fi/docs/features/tax-compliance.md): VAT, GST, and sales tax across 190+ countries. Calculated, collected, and remitted automatically.
- [Telegram Integration](https://documentation.suby.fi/docs/features/telegram-integration.md): Sell access to Telegram groups and channels with a native checkout experience.
- [Transactions](https://documentation.suby.fi/docs/features/transactions.md): The complete log of every payment event across your account.
- [Use with AI](https://documentation.suby.fi/docs/introduction/AI.md): Integrate your product into your app in one click with your favorite AI builder.
- [Account Reviews](https://documentation.suby.fi/docs/introduction/account-reviews.md): Learn how account reviews work on Suby, and how to make yours successful.
- [Quickstart](https://documentation.suby.fi/docs/introduction/quickstart.md): Accept your first payment in under 5 minutes.
- [Refer businesses to Suby](https://documentation.suby.fi/docs/introduction/refer.md): Earn 30% commission on every business you bring to Suby.
- [What is Suby?](https://documentation.suby.fi/docs/introduction/what-is-suby.md): The payment infrastructure for internet businesses. Cards, stablecoins, subscriptions, and global tax compliance in one place.
- [Compliance](https://documentation.suby.fi/docs/legal/compliance.md): Suby operates as a non-custodial payment orchestration layer, relying on licensed third-party partners to ensure regulatory compliance across fiat and crypto payment flows.
- [Custody](https://documentation.suby.fi/docs/legal/custody.md): Suby is a non-custodial technology provider and does not provide custody services.
- [Privacy Policy](https://documentation.suby.fi/docs/legal/privacy-policy.md)
- [Terms & Conditions ](https://documentation.suby.fi/docs/legal/terms-and-conditions.md): Last updated: February 4, 2026
- [Review Process](https://documentation.suby.fi/docs/merchants/account-review-process.md): How we evaluate your business before onboarding you on Suby.
- [Supported Businesses](https://documentation.suby.fi/docs/merchants/supported-businesses.md): Which business types Suby supports and which are not permitted on the platform.
- [Supported Countries](https://documentation.suby.fi/docs/merchants/supported-countries.md): Suby's checkout is available globally, with restrictions in sanctioned regions.
- [Supported Currencies](https://documentation.suby.fi/docs/merchants/supported-currencies.md): What customers can pay with at checkout, and how pricing and conversions work.
- [Taxes & VAT Handling](https://documentation.suby.fi/docs/merchants/taxes-vat.md): How Suby calculates, collects, and remits taxes automatically on every transaction.
- [What is a Merchant of Record?](https://documentation.suby.fi/docs/merchants/what-is-a-merchant-of-record.md): How Suby handles tax compliance, liability, and global payment infrastructure on your behalf.
- [Understand Your Fees](https://documentation.suby.fi/docs/payment/fees.md): Transparent, predictable pricing on every transaction, card and crypto.
- [Pay-ins & Payouts](https://documentation.suby.fi/docs/payment/payins-payouts.md): Supported payment methods and payout options on Suby.
- [Stablecoin & Crypto Payments](https://documentation.suby.fi/docs/payment/stablecoins.md)
- [Suby Sandbox](https://documentation.suby.fi/docs/sandbox/suby-sandbox.md): Test payments end-to-end without touching real funds.
- [Agencies & freelancers](https://documentation.suby.fi/docs/who/agencies.md)
- [Paid communities](https://documentation.suby.fi/docs/who/communities.md)
- [E-commerce](https://documentation.suby.fi/docs/who/ecom.md)
- [SaaS & webapps](https://documentation.suby.fi/docs/who/saas.md)
- [Discord Bot Commands](https://documentation.suby.fi/guides/discord/bot-commands.md): Manage your Suby integration directly from Discord using slash commands.
- [Discord Checkout (Optional)](https://documentation.suby.fi/guides/discord/checkout.md): Create a Discord-native checkout channel for all your paid access links, with a built-in checkout.
- [Notification Setup](https://documentation.suby.fi/guides/discord/notifications.md): Configure renewal reminders and subscription notifications for your Discord server.
- [Discord Overview](https://documentation.suby.fi/guides/discord/overview.md): Accept payments and manage paid access for your Discord server with Suby.
- [How to Give Discord Permissions](https://documentation.suby.fi/guides/discord/permissions.md): Configure the Suby bot permissions on your Discord server.
- [Discord Integration Setup](https://documentation.suby.fi/guides/discord/setup.md): Connect your Discord server to Suby and start gating access with paid roles in minutes.
- [Troubleshooting](https://documentation.suby.fi/guides/discord/troubleshooting.md): Common setup issues and how to fix them.
- [Telegram Checkout (Optional)](https://documentation.suby.fi/guides/telegram/checkout.md): Create a Telegram-native entry point for all your paid access links, with a built-in checkout.
- [Telegram Overview](https://documentation.suby.fi/guides/telegram/overview.md): Accept payments and manage paid access for your Telegram groups and channels with Suby.
- [Telegram Integration Setup](https://documentation.suby.fi/guides/telegram/setup.md): Connect your Telegram group or channel to Suby and start gating access in minutes.
- [Fraud Prevention System ](https://documentation.suby.fi/merchant-of-record-facilitator/fraud-prevention-system.md): Our fraud prevention system protects against automated attacks, card testing, and suspicious payment activity. It combines bot detection, card testing prevention, and device fingerprinting.
- [Supported Regions ](https://documentation.suby.fi/merchant-of-record-facilitator/supported-regions.md): Suby’s checkout is available globally and can be used by customers in most countries worldwide.

## OpenAPI Specs

- [openapi](https://documentation.suby.fi/openapi.yaml)

## Optional

- [Roadmap](https://roadmap.suby.fi)
- [Suby vs alternatives](https://compare.suby.fi)