# Waffo Documentation

## Docs

- [Chargeback accept](https://waffo.com/docs/api-reference/chargeback-accept/chargeback-accept.md)
- [Chargeback file download](https://waffo.com/docs/api-reference/chargeback-file-download/chargeback-file-download.md)
- [Chargeback file upload](https://waffo.com/docs/api-reference/chargeback-file-upload/chargeback-file-upload.md)
- [Chargeback inquiry](https://waffo.com/docs/api-reference/chargeback-inquiry/chargeback-inquiry.md)
- [Chargeback list](https://waffo.com/docs/api-reference/chargeback-list/chargeback-list.md)
- [Chargeback update](https://waffo.com/docs/api-reference/chargeback-update/chargeback-update.md)
- [Introduction](https://waffo.com/docs/api-reference/introduction.md): Waffo Acquiring Order API reference
- [Merchant Config inquiry](https://waffo.com/docs/api-reference/merchant-config-inquiry/merchant-config-inquiry.md)
- [Order cancel](https://waffo.com/docs/api-reference/order-cancel/order-cancel.md)
- [Create new order](https://waffo.com/docs/api-reference/order-create/create-new-order.md): Note: For certain Pay Methods, some optional fields are required. Kindly refer to Section Specific Pay Method Requirement
- [Order inquiry](https://waffo.com/docs/api-reference/order-inquiry/order-inquiry.md)
- [Order refund](https://waffo.com/docs/api-reference/order-refund/order-refund.md)
- [Pay Method Config Inquiry](https://waffo.com/docs/api-reference/pay-method-config-inquiry/pay-method-config-inquiry.md)
- [Refund inquiry](https://waffo.com/docs/api-reference/refund-inquiry/refund-inquiry.md)
- [Subscription cancel](https://waffo.com/docs/api-reference/subscription-cancel/subscription-cancel.md)
- [Subscription change inquiry](https://waffo.com/docs/api-reference/subscription-change-inquiry/subscription-change-inquiry.md)
- [Subscription change](https://waffo.com/docs/api-reference/subscription-change/subscription-change.md)
- [Create Subscription](https://waffo.com/docs/api-reference/subscription-create/create-subscription.md): Note: For certain Pay Methods, some optional fields are required. Kindly refer to Section Specific Pay Method Requirement
- [Subscription Inquiry](https://waffo.com/docs/api-reference/subscription-inquiry/subscription-inquiry.md)
- [Subscription manage](https://waffo.com/docs/api-reference/subscription-manage/subscription-manage.md)
- [Tokenization Generate](https://waffo.com/docs/api-reference/waffo-tokenization-api/tokenization-generate.md)
- [Tokenization Inquiry](https://waffo.com/docs/api-reference/waffo-tokenization-api/tokenization-inquiry.md)
- [Tokenization remove](https://waffo.com/docs/api-reference/waffo-tokenization-api/tokenization-remove.md)
- [Amounts and currencies](https://waffo.com/docs/en/developer-docs/core-concepts/currency.md): Waffo amount formatting specifications and multi-currency payment guidance.
- [Error Handling](https://waffo.com/docs/en/developer-docs/core-concepts/error-handling.md): A guide to Waffo API error code categories and handling Unknown Status exceptions.
- [Idempotency](https://waffo.com/docs/en/developer-docs/core-concepts/idempotency.md): Use idempotency keys to prevent duplicate charges and ensure payment security.
- [Payment lifecycle and order statuses](https://waffo.com/docs/en/developer-docs/core-concepts/payment-lifecycle.md): Learn how Waffo payment orders, subscriptions, and refunds transition between statuses.
- [Go-live checklist](https://waffo.com/docs/en/developer-docs/getting-started/go-live.md): A complete checklist before switching from the sandbox to the production environment.
- [Integration overview](https://waffo.com/docs/en/developer-docs/getting-started/overview.md): An overview of Waffo's core capabilities and integration flow as a one-stop global payments platform.
- [Integration guide](https://waffo.com/docs/en/developer-docs/getting-started/quickstart.md): Complete your first payment in 5 minutes and quickly integrate Waffo Payments.
- [Sandbox and testing](https://waffo.com/docs/en/developer-docs/getting-started/sandbox.md): Complete full integration testing in the sandbox environment without real funds.
- [AI integration tool (waffo-integrate)](https://waffo.com/docs/en/developer-docs/integration/ai-integration.md): Automatically complete Waffo SDK integration with AI coding tools—33% faster than manual integration, with a 100% success rate.
- [API-only integration - code examples](https://waffo.com/docs/en/developer-docs/integration/api/examples.md): Multilingual API integration code examples for Node.js, Java, and cURL.
- [API integration](https://waffo.com/docs/en/developer-docs/integration/api/overview.md): A manual API integration roadmap for one-time payment and subscription payment.
- [Checkout integration - parameter configuration](https://waffo.com/docs/en/developer-docs/integration/checkout/configuration.md): Required and optional parameters for Checkout integration.
- [Cashier integration - Customization options](https://waffo.com/docs/en/developer-docs/integration/checkout/customization.md): Configurations such as cashier payment method filtering, multi-currency, language, and theme customization.
- [Checkout integration - Integration steps](https://waffo.com/docs/en/developer-docs/integration/checkout/steps.md): The complete process for integrating payments using the Waffo hosted Checkout.
- [Frontend component - Google Pay integration](https://waffo.com/docs/en/developer-docs/integration/elements/frontend-integration.md): A complete guide to integrating Google Pay payments on the merchant page.
- [Frontend components - Style customization](https://waffo.com/docs/en/developer-docs/integration/elements/styling.md): Customization options for cashier appearance, language, and payment method filtering.
- [Frontend components - component usage](https://waffo.com/docs/en/developer-docs/integration/elements/usage.md): How to integrate frontend components to embed payment capabilities into merchant pages.
- [Generate token](https://waffo.com/docs/en/developer-docs/integration/tokenization/generate.md): Initiate a card binding request and obtain `tokenSessionId` for use by the frontend SDK.
- [Token inquiry](https://waffo.com/docs/en/developer-docs/integration/tokenization/inquiry.md): Query the list of Tokens already bound by the user.
- [Card binding and token management](https://waffo.com/docs/en/developer-docs/integration/tokenization/overview.md): Securely convert users’ bank card information into a token so future payments don’t require entering the card number again.
- [Token unbinding](https://waffo.com/docs/en/developer-docs/integration/tokenization/remove.md): Delete a bound Token. After unbinding, the Token can no longer be used for payments.
- [SDK changelog](https://waffo.com/docs/en/developer-docs/sdk/changelog.md): Changelog for Waffo Node.js, Java, and Go SDK releases.
- [Go SDK](https://waffo.com/docs/en/developer-docs/sdk/go.md): Waffo Go SDK installation, initialization, and usage guide.
- [Java SDK](https://waffo.com/docs/en/developer-docs/sdk/java.md): Installation, initialization, and usage guide for the Waffo Java SDK.
- [Node.js SDK](https://waffo.com/docs/en/developer-docs/sdk/nodejs.md): Waffo Node.js SDK installation, initialization, and usage guide.
- [Error code quick reference](https://waffo.com/docs/en/developer-docs/tools-and-references/developer-tools/error-codes.md): A complete list of Waffo API error codes and category descriptions.
- [Postman collection](https://waffo.com/docs/en/developer-docs/tools-and-references/developer-tools/postman.md): Use the Postman collection to quickly test the Waffo API.
- [Sandbox simulator](https://waffo.com/docs/en/developer-docs/tools-and-references/developer-tools/sandbox-simulator.md): Instructions for using the simulator in the sandbox environment to simulate various payment scenarios.
- [Integration acceptance criteria](https://waffo.com/docs/en/developer-docs/tools-and-references/references/acceptance-criteria.md): Acceptance criteria for merchants after completing Waffo integration, covering functional tests, exception handling, parameter requirements, and data integrity.
- [Changelog and version migration guide](https://waffo.com/docs/en/developer-docs/tools-and-references/references/changelog.md): Waffo API version history and changelog.
- [Frequently asked questions (FAQ)](https://waffo.com/docs/en/developer-docs/tools-and-references/references/faq.md): Common questions and answers about Waffo integration, payments, and security.
- [Payment method integration notes](https://waffo.com/docs/en/developer-docs/tools-and-references/references/payment-method-integration-notes.md): Payment method and environment-specific notes for Checkout integrations.
- [Data reference](https://waffo.com/docs/en/developer-docs/tools-and-references/references/status-codes.md): A complete reference for Waffo status codes, enums, payment method types, and general conventions.
- [Checkout customization](https://waffo.com/docs/en/developer-docs/use-cases/checkout-customization.md): Customize the checkout appearance, logo, language, and payment methods via API parameters, Portal settings, or SDK initialization.
- [Checkout solution](https://waffo.com/docs/en/developer-docs/use-cases/checkout-solution.md): Comparison of Waffo's two checkout integration modes and their request parameter patterns.
- [Pricing currency strategy](https://waffo.com/docs/en/developer-docs/use-cases/pricing-currency.md): An overview of the three pricing currency strategies supported by Waffo: global uniform pricing, per-country pricing, and regional pricing, including how to pass the correct parameters.
- [Webhook - Handling best practices](https://waffo.com/docs/en/developer-docs/webhook/best-practices.md): Best practices for webhook handling: idempotency, fast responses, security, and more.
- [Webhook - event type list](https://waffo.com/docs/en/developer-docs/webhook/event-types.md): Detailed descriptions and payload examples for all Waffo Webhook event types.
- [Webhook - Overview and configuration](https://waffo.com/docs/en/developer-docs/webhook/overview.md): Overview and configuration requirements for Waffo Webhook asynchronous event notifications.
- [Webhook - retries and failure recovery](https://waffo.com/docs/en/developer-docs/webhook/retry.md): Webhook retry mechanism and failure recovery strategy.
- [Webhook - signature verification](https://waffo.com/docs/en/developer-docs/webhook/signature-verification.md): RSA signature verification method and code examples for Webhook requests.
- [Auth-Capture](https://waffo.com/docs/en/essentials/auth-capture.md): Split payments into two steps — authorize funds upfront and capture them only when the transaction is confirmed, reducing fraud risk and refund costs.
- [Checkout](https://waffo.com/docs/en/essentials/checkout.md): Waffo's standardized checkout product for managing global payment interaction flows across one-time and subscription payment modes.
- [Data Intelligence](https://waffo.com/docs/en/essentials/data-intelligence.md): End-to-end data intelligence that translates obscure bank codes into actionable growth strategies.
- [Dispute and Chargeback](https://waffo.com/docs/en/essentials/dispute-chargeback.md): A systematic, tiered closed-loop defense system covering three core stages: Chargeback Alert, Customer Dispute, and Chargeback.
- [Merchant Portal](https://waffo.com/docs/en/essentials/merchant-portal.md): A one-stop payment management platform for cross-border enterprises. Manage transactions, settlements, analytics, and team access in one place.
- [Merchant Settlement](https://waffo.com/docs/en/essentials/merchant-settlement.md): Intelligent and transparent global fund settlement service that automatically converts multi-currency transactions and optimizes merchants' cash flow via flexible settlement strategies.
- [One-time Payment](https://waffo.com/docs/en/essentials/one-time-payment.md): One integration, global payment methods covered — every transaction clear and in control.
- [Payment Methods](https://waffo.com/docs/en/essentials/payment-methods.md): Connect your business to mainstream global and distinctive local payment methods through a single, unified API interface.
- [Waffo Product Overview](https://waffo.com/docs/en/essentials/product-overview.md): Building global payment infrastructure. A full-stack solution from acquiring to growth.
- [Subscription & Recurring](https://waffo.com/docs/en/essentials/subscription-recurring.md): Providing automated, high-success-rate billing solutions for recurring payment scenarios. Through a mechanism of one-time authorization and multiple automated deductions, we support flexible billing cycle configurations and smart retries.
- [Tokenization](https://waffo.com/docs/en/essentials/tokenization.md): Securely store payment credentials using Waffo Tokens to enable one-click checkout, recurring billing, and delayed charges without handling raw card numbers.

## OpenAPI Specs

- [tokenization-api](https://waffo.com/docs/api-reference/tokenization-api.json)
- [chargeback-api](https://waffo.com/docs/api-reference/chargeback-api.json)
- [openapi](https://waffo.com/docs/api-reference/openapi.json)