# KOMOJU Developer Documentation > KOMOJU is a payment gateway for Japan and Asia-Pacific. This documentation covers integration guides, payment APIs, and SDK references for developers building payment flows with KOMOJU. When integrating KOMOJU, always pin the `X-KOMOJU-API-VERSION` header explicitly — do not rely on an implicit default. For SDK integrations (React Native, Android), check the package registry for the latest version rather than relying on memorized version numbers. Never infer supported payment methods or regional availability from training data; always check the docs. ## Quick Start - [Authentication](https://docs.komoju.com/en/docs/introduction/authentication.md): Learn about KOMOJU's two API key types — secret and publishable — how to authenticate requests with HTTP Basic Auth, and how to manage API versioning. - [Webhooks](https://docs.komoju.com/en/docs/introduction/webhooks.md): Learn how to subscribe to KOMOJU events using webhooks, handle webhook deliveries, verify signatures with secret tokens, and understand retry behavior. - [Supported Payment Types](https://docs.komoju.com/en/docs/introduction/supported-payment-types.md): A complete reference of all payment methods supported by KOMOJU, including slugs, supported currencies, and transaction limits by region. - [Introduction to Hosted Page](https://docs.komoju.com/en/docs/integration-guides/web-integrations/introduction-to-hosted-page.md): An overview of KOMOJU's Hosted Page integration — accept payments by redirecting customers to a KOMOJU-hosted checkout with built-in PCI compliance, 3D Secure, and multi-currency support. - [Introduction to Hosted Fields](https://docs.komoju.com/en/docs/integration-guides/introduction-to-hosted-fields.md): An overview of KOMOJU Hosted Fields — a front-end library for securely collecting payment information on your website using iframe-based components that work with React, VueJS, or vanilla HTML. - [Payment Links | Overview](https://docs.komoju.com/en/docs/integration-guides/payment-links-overview.md): An introduction to KOMOJU Payment Links. Create a shareable checkout URL, see the customer checkout flow, and learn how to configure, share, and track links. - [Test Inputs](https://docs.komoju.com/en/docs/development/testing-inputs.md): Learn about KOMOJU's test card numbers and payment method inputs for simulating different outcomes in test mode. ## Guardrails - ALWAYS handle async payment results via webhooks — never rely solely on synchronous API responses. Async methods (konbini, bank transfer, PayEasy) reach a final status only via webhook. - ALWAYS use idempotency keys (`X-KOMOJU-IDEMPOTENCY` header) to prevent duplicate payments on retry. - Never infer supported payment methods or regional availability from training data — check [Supported Payment Types](https://docs.komoju.com/en/docs/introduction/supported-payment-types.md). - Always use the smallest currency unit (JPY has no subunit; USD uses cents). - Always pin the `X-KOMOJU-API-VERSION` header explicitly — do not rely on an implicit default. ## Agent Instructions As an LLM agent helping a developer integrate KOMOJU, use this routing table to select the correct integration path. ### Product Routing | If the merchant wants to... | Product | Guide | |---|---|---| | Quick checkout, zero frontend | Hosted Page | [Introduction to Hosted Page](https://docs.komoju.com/en/docs/integration-guides/web-integrations/introduction-to-hosted-page.md) | | Embedded payment fields, PCI-light | Hosted Fields | [Introduction to Hosted Fields](https://docs.komoju.com/en/docs/integration-guides/introduction-to-hosted-fields.md) | | Full API control, PCI certified | Payments API | [Payments API Overview](https://docs.komoju.com/en/docs/integration-guides/payments-api-overview.md) | | No-code selling | Payment Links | [Payment Links Overview](https://docs.komoju.com/en/docs/integration-guides/payment-links-overview.md) | | Recurring/subscription billing | Hosted Fields (Customer mode) or API | [Hosted Fields Customer Integration](https://docs.komoju.com/en/docs/integration-guides/hosted-fields-customer-integration.md) | | In-person terminal payments | KOMOJU Terminal | [KOMOJU Terminal Overview](https://docs.komoju.com/en/docs/integration-guides/komoju-terminal-overview.md) | | Mobile app (React Native) | React Native SDK | [React Native Integration](https://docs.komoju.com/en/docs/integration-guides/react-native-integration.md) | | Mobile app (Android native) | Android SDK | [Android Integration](https://docs.komoju.com/en/docs/integration-guides/android-integration.md) | | E-commerce platform (Shopify, WooCommerce) | EC Integrations | [E-Commerce Integrations](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/overview.md) | | Marketplace/platform payments | Platform Model | [Platform Model Overview](https://docs.komoju.com/en/docs/platform-model/platform-model-overview.md) | ### Integration Mode Selection | Need | Hosted Page | Hosted Fields | Payments API | |---|---|---|---| | Quick launch, zero frontend | Yes | No | No | | Brand embedding, low-code | No | Yes | No | | Full control, API-only | No | No | Yes | | No PCI certification | Yes | Yes | No | | Recurring billing | Customer mode | Customer mode | Customer object | ## Key Technical Patterns **Hosted Page flow:** Server creates a Session via `POST /api/v1/sessions` → redirect customer to `session_url` → customer completes payment on KOMOJU-hosted page → customer redirected to `return_url` with `session_id` query param → server receives webhook with final payment status. **Hosted Fields flow:** Server creates a Session → frontend mounts Hosted Fields with `session-id` → customer enters payment details in iframe fields → frontend submits → customer redirected to `return_url` → server receives webhook with final payment status. **Direct Payments API flow:** Server calls `POST /api/v1/payments` with `payment_details` → response contains payment status (may be `pending` for async methods) → server receives webhook with final payment status. **Subscription/token flow:** Create a Customer with payment details → receive `customer.id` → create Payments with `customer` parameter → KOMOJU charges the stored payment method → server receives webhook for each charge. **Platform Model flow:** Onboard accounts (Platform Merchant + Seller/Payout Merchants) → process payments between platform and sellers → configure payout settings → receive payouts to bank account. Note: subscriptions are not supported in Platform Model. ## Introduction - [What is KOMOJU](https://docs.komoju.com/en/docs/introduction/what-is-komoju.md): An introduction to KOMOJU as a payment service provider for the Japanese market — covering what it does, why teams choose KOMOJU, integration options, and how payments move through the system. - [Authentication](https://docs.komoju.com/en/docs/introduction/authentication.md): Learn about KOMOJU's two API key types — secret and publishable — how to authenticate requests with HTTP Basic Auth, and how to manage API versioning. - [Payments](https://docs.komoju.com/en/docs/introduction/payments.md): Learn what a KOMOJU payment resource is, the six payment statuses (including the two meanings of "authorized"), and how payment details represent method-specific data. - [Idempotent Requests](https://docs.komoju.com/en/docs/introduction/idempotent-requests.md): Learn how KOMOJU supports idempotent POST requests using the X-KOMOJU-IDEMPOTENCY header to safely retry operations without duplicating captures or refunds. - [Webhooks](https://docs.komoju.com/en/docs/introduction/webhooks.md): Learn how to subscribe to KOMOJU events using webhooks, handle webhook deliveries, verify signatures with secret tokens, and understand retry behavior. - [Errors](https://docs.komoju.com/en/docs/introduction/errors.md): Learn how KOMOJU uses HTTP status codes and JSON error objects to report failures, and explore the full list of error codes you may encounter. - [Supported Payment Types](https://docs.komoju.com/en/docs/introduction/supported-payment-types.md): A complete reference of all payment methods supported by KOMOJU, including slugs, supported currencies, and transaction limits by region. ## Integration Guides - [Web Integrations](https://docs.komoju.com/en/docs/integration-guides/web-integrations/overview.md): Choose how to integrate KOMOJU into your website. Redirect customers to a KOMOJU-hosted checkout with Hosted Page or embed secure input fields on your own page with Hosted Fields. - [Introduction to Hosted Page](https://docs.komoju.com/en/docs/integration-guides/web-integrations/introduction-to-hosted-page.md): An overview of KOMOJU's Hosted Page integration — accept payments by redirecting customers to a KOMOJU-hosted checkout with built-in PCI compliance, 3D Secure, and multi-currency support. - [Hosted Page | Standard Mode](https://docs.komoju.com/en/docs/integration-guides/hosted-page-standard-mode.md): Step-by-step guide to accepting payments with the KOMOJU Hosted Page — covering session creation, customer redirection, return URL handling, webhook setup, and one-click payments for returning customers. - [Hosted Page | Customer Mode](https://docs.komoju.com/en/docs/integration-guides/hosted-page-customer-mode.md): How to use KOMOJU Hosted Page in customer mode to collect and tokenize payment details for future charges — covering session creation, customer.updated webhooks, and making payments with a stored customer ID. - [Introduction to Hosted Fields](https://docs.komoju.com/en/docs/integration-guides/introduction-to-hosted-fields.md): An overview of KOMOJU Hosted Fields — a front-end library for securely collecting payment information on your website using iframe-based components that work with React, VueJS, or vanilla HTML. - [Hosted Fields | Standard Integration](https://docs.komoju.com/en/docs/integration-guides/hosted-fields-standard-integration.md): Step-by-step guide to integrating KOMOJU Hosted Fields in standard mode — covering session creation, rendering payment fields on the frontend, and handling form submission. - [Hosted Fields | Customer Integration](https://docs.komoju.com/en/docs/integration-guides/hosted-fields-customer-integration.md): Guide to using KOMOJU Hosted Fields in customer mode — collecting payment tokens for long-term storage and repeated use, such as subscription billing. - [Hosted Fields | Tokens Integration](https://docs.komoju.com/en/docs/integration-guides/hosted-fields-tokens-integration.md): Guide to using KOMOJU Hosted Fields in token mode — collecting a payment token from the browser and processing it server-side, suitable for custom subscription or billing systems. - [Hosted Fields | Custom Styling](https://docs.komoju.com/en/docs/integration-guides/hosted-fields-custom-styling.md): Learn how to apply custom CSS to your KOMOJU Hosted Fields integration using the theme attribute. - [Hosted Fields | Handling Errors](https://docs.komoju.com/en/docs/integration-guides/hosted-fields-handling-errors.md): Learn how to catch and handle errors in KOMOJU Hosted Fields using the komoju-error event. - [Hosted Fields | Supported Payment Methods](https://docs.komoju.com/en/docs/integration-guides/hosted-fields-supported-payment-methods.md): A reference listing which payment methods are supported by KOMOJU Hosted Fields across payment mode, customer mode, and token mode. - [Payment Links | Overview](https://docs.komoju.com/en/docs/integration-guides/payment-links-overview.md): An introduction to KOMOJU Payment Links. Create a shareable checkout URL, see the customer checkout flow, and learn how to configure, share, and track links. - [Payment Links | Subscriptions](https://docs.komoju.com/en/docs/integration-guides/payment-links-subscriptions.md): Learn how to create and manage subscription payment links with KOMOJU. Accept recurring payments through payment links with flexible frequency options. - [React Native Integration](https://docs.komoju.com/en/docs/integration-guides/react-native-integration.md): Integrate KOMOJU payments into your React Native application using the official SDK. Supports multiple payment methods including Konbini, PayPay, and credit cards with minimal PCI burden. - [Android Integration](https://docs.komoju.com/en/docs/integration-guides/android-integration.md): Integrate KOMOJU payments into your Android application using the official SDK. Supports Konbini, PayPay, and credit cards with composable UI components and theme customization. - [Introduction to Payments API](https://docs.komoju.com/en/docs/integration-guides/introduction-to-payments-api.md): Learn the fundamentals of KOMOJU's Payments API. Understand how the modular API endpoints work together to support complex payment integration requirements. - [Payments API | Overview](https://docs.komoju.com/en/docs/integration-guides/payments-api-overview.md): Learn how to create payments directly using KOMOJU's Payments API. Understand Session-based and direct payment methods with step-by-step integration guidance. - [Payments API | Payment Details](https://docs.komoju.com/en/docs/integration-guides/payments-api-payment-details.md): Complete reference for payment method-specific details required by KOMOJU's Payments API. Covers credit cards, konbini, bank transfers, and mobile payments. - [Payments API | Fraud Details](https://docs.komoju.com/en/docs/integration-guides/payments-api-fraud-details.md): Reference for KOMOJU's fraud_details object. Pass customer information to reduce chargebacks and improve transaction legitimacy detection. - [Payments API | 3DS](https://docs.komoju.com/en/docs/integration-guides/payments-api-3ds.md): Learn how to implement 3D Secure (3DS) authentication for direct payments using KOMOJU's Secure Tokens API. - [KOMOJU Terminal | Overview](https://docs.komoju.com/en/docs/integration-guides/komoju-terminal-overview.md): Visual guide to KOMOJU Terminal screens and payment flow. Understand the terminal UI for manual payment initiation, method selection, and transaction management. - [KOMOJU Terminal | Cloud API](https://docs.komoju.com/en/docs/integration-guides/komoju-terminal-cloud-api.md): Learn how to use KOMOJU Cloud Terminal API to initiate payments on terminal devices, handle webhooks, and manage receipts and sessions. - [KOMOJU Terminal | Payment Management](https://docs.komoju.com/en/docs/integration-guides/komoju-terminal-payment-management.md): Learn how to manage transactions on KOMOJU Terminal devices including refunds, captures, cancellations, and receipt reprinting. - [KOMOJU Terminal | Third Party Integrations](https://docs.komoju.com/en/docs/integration-guides/komoju-terminal-third-party-integrations.md): Learn how to start payment transactions on KOMOJU Terminal from third-party applications using the komoju:// URL scheme. - [E-Commerce Integrations](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/overview.md): An overview of KOMOJU's e-commerce platform integrations. Add credit cards, PayPay, Konbini, and other local payment methods to platforms like Shopify and WooCommerce without writing code. - [Getting Started with Shopify](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/shopify/getting-started-with-shopify.md): Step-by-step guide to connect your KOMOJU account to your Shopify store, including setup, testing, and going live with payment methods. - [KOMOJU Orders on Shopify](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/shopify/komoju-orders-on-shopify.md): Learn how KOMOJU payments connect to Shopify orders, where to find payment information in both platforms, and understand the payment lifecycle and visibility. - [KOMOJU Features on Shopify](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/shopify/komoju-features-on-shopify.md): Learn about commonly used KOMOJU features including skip order completion page and oversell protection to optimize your Shopify checkout experience. - [Getting Started with WooCommerce](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/woocommerce/getting-started-with-woocommerce.md): Install the KOMOJU Payments plugin, connect your account, enable payment methods, and run test payments before going live. - [KOMOJU Orders on WooCommerce](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/woocommerce/komoju-orders-on-woocommerce.md): Learn how KOMOJU payments connect to WooCommerce orders, find payment information in each dashboard, and understand how order statuses stay in sync. - [KOMOJU Features on WooCommerce](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/woocommerce/komoju-features-on-woocommerce.md): Configure WooCommerce-specific KOMOJU features including payment method titles, descriptions, and inline payment fields. - [Getting Started with Wix](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/wix/getting-started-with-wix.md): Connect KOMOJU to your Wix store, configure payment settings, enable payment methods, and go live with Japanese payment methods. - [KOMOJU Orders on Wix](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/wix/komoju-orders-on-wix.md): Learn how Wix and KOMOJU record orders, match Payment IDs across systems, and manage order lifecycles and carrier payments. - [Getting Started with EC-CUBE](https://docs.komoju.com/en/docs/integration-guides/ec-integrations/ec-cube/getting-started-with-ec-cube.md): Install the KOMOJU Payment plugin on EC-CUBE, configure credentials, sync payment methods, set up webhooks, and run test payments. - [Apple Pay Eligibility Criteria](https://docs.komoju.com/en/docs/integration-guides/apple-pay/eligibility-criteria.md): Review the corporate structure, location, and integration requirements needed to enable Apple Pay on your KOMOJU account. - [Using Apple Pay (Hosted Page/Fields)](https://docs.komoju.com/en/docs/integration-guides/apple-pay/using-apple-pay.md): Accept Apple Pay payments on your store using KOMOJU Hosted Page or Hosted Fields, including domain registration instructions. - [Using Apple Pay (API)](https://docs.komoju.com/en/docs/integration-guides/apple-pay/using-apple-pay-api.md): Step-by-step implementation guide for integrating Apple Pay via the direct KOMOJU Payments API, including merchant validation and payment authorization. ## Development - [Test Inputs](https://docs.komoju.com/en/docs/development/testing-inputs.md): Learn about KOMOJU's test card numbers and payment method inputs for simulating different outcomes in test mode. - [Tokenizing Payment Details](https://docs.komoju.com/en/docs/development/tokenizing-payment-details.md): Learn how to tokenize credit card details on the client side to avoid PCI-DSS burden while still using KOMOJU's full payments API. - [Long Term Tokens](https://docs.komoju.com/en/docs/development/long-term-tokens.md): Learn how to store payment details long-term using KOMOJU Customer objects, enabling use cases like subscriptions and card-on-file payments. - [Stored Credential Compliance](https://docs.komoju.com/en/docs/development/stored-credential-compliance.md): Learn how to use stored credential compliance fields to reduce decline rates for card-on-file and subscription payments. - [Two-Step Capture](https://docs.komoju.com/en/docs/development/advanced-payments/two-step-payments.md): Learn how KOMOJU's two-step capture works — separating payment authorization from capture — and when to use it in flows like physical goods shipping. - [Testing 3DS](https://docs.komoju.com/en/docs/development/testing-3ds.md): Learn how to test 3D Secure 2.0 flows in KOMOJU using test card numbers that simulate various authentication outcomes. - [Setting Up 3DS MPI](https://docs.komoju.com/en/docs/development/setting-up-3ds-mpi.md): Learn how to use your own 3DS MPI with KOMOJU's credit card processing API to maintain control over your 3D Secure flow. - [Dynamic Descriptor Parameters](https://docs.komoju.com/en/docs/development/dynamic-descriptor-parameters.md): Learn how to set per-payment or per-session MCCs and dynamic statement descriptors to help customers identify charges from multiple brands. - [Chargeback Management API](https://docs.komoju.com/en/docs/development/chargeback-management-api.md): Learn how to use the Chargeback Management API to programmatically retrieve, manage, accept, and defend chargebacks and disputes. - [Ruby SDK](https://docs.komoju.com/en/docs/development/sdks/ruby.md): Official KOMOJU Ruby SDK client library for interacting with the KOMOJU Payments API, including session creation and webhook signature verification. - [Node SDK](https://docs.komoju.com/en/docs/development/sdks/node.md): Official KOMOJU TypeScript/JavaScript Node SDK client library for the KOMOJU Payments API, including session management and error handling. - [PHP SDK](https://docs.komoju.com/en/docs/development/sdks/php.md): Official KOMOJU PHP SDK client library for the KOMOJU Payments API, including session creation, webhook verification, and exception handling. - [MultiPay (Legacy)](https://docs.komoju.com/en/docs/development/multipay-legacy.md): Integration guide for KOMOJU MultiPay popup iframe widget (legacy). For new integrations, use Hosted Fields. - [Buys Deprecation](https://docs.komoju.com/en/docs/development/buys-deprecation.md): Information on the retirement of KOMOJU Buys and automatic migration to Payment Links. ## Platform Model - [Platform Model | Overview](https://docs.komoju.com/en/docs/platform-model/platform-model-overview.md): An overview of the KOMOJU Platform Model for Platform and Marketplace Businesses, covering onboarding, payment processing, balance transfers, payouts, and account management. - [Platform Model | Glossary](https://docs.komoju.com/en/docs/platform-model/platform-model-glossary.md): Definitions of specialized terms used in the KOMOJU Platform Model, including account types, payment processing models, payment methods, and fees. - [Platform Model | Use Cases](https://docs.komoju.com/en/docs/platform-model/platform-model-use-cases.md): Learn how to identify whether your business falls under the Platform Use Case or the Marketplace Use Case in the KOMOJU Platform Model. - [Introduction to Platform Businesses](https://docs.komoju.com/en/docs/platform-model/introduction-to-platform-businesses.md): An overview of the Platform Use Case in the KOMOJU Platform Model, including merchant account setup, onboarding, fund flow, payment processing, and fee structures. - [Platform Business Onboarding](https://docs.komoju.com/en/docs/platform-model/platform-business-onboarding.md): Steps to register and onboard a Platform Merchant (Platform Business) account with KOMOJU, from obtaining test credentials through live application approval. - [Seller Merchant Onboarding](https://docs.komoju.com/en/docs/platform-model/seller-merchant-onboarding.md): How to register and onboard a Seller Merchant account for your sellers via the KOMOJU API, including live application fields, payment method setup, and test simulation. - [Seller Merchant Payment Processing](https://docs.komoju.com/en/docs/platform-model/seller-merchant-payment-processing.md): How to process payments using the Seller Processing Model, including creating payments, two-step capture, refunds, chargebacks, and a summary of transaction record types. - [Introduction to Marketplace Businesses](https://docs.komoju.com/en/docs/platform-model/introduction-to-marketplace-businesses.md): An overview of the Marketplace Business use case, including merchant account setup, onboarding steps, end-to-end fund flow, payment processing, and fee structures for Platform and Payout Merchants. - [Marketplace Business Onboarding](https://docs.komoju.com/en/docs/platform-model/marketplace-business-onboarding.md): Steps to register and onboard a Platform Merchant (Marketplace Business) account with KOMOJU, from obtaining test credentials through live application approval. - [Payout Merchant Onboarding](https://docs.komoju.com/en/docs/platform-model/payout-merchant-onboarding.md): How to register and onboard a Payout Merchant account for your sellers via the KOMOJU API, including live application fields, bank account setup, and webhook configuration. - [Platform Merchant Payment Processing](https://docs.komoju.com/en/docs/platform-model/platform-merchant-payment-processing.md): How to process payments using the Platform Processing Model, including creating payments, two-step capture, refunds, chargebacks, and a summary of transaction record types. - [Payment Processing Overview](https://docs.komoju.com/en/docs/platform-model/payment-processing-overview.md): An overview of payment processing in the Platform Model, covering the processing merchant concept, available payment actions, and links to the Seller and Platform Processing Models. - [Balance Transfers](https://docs.komoju.com/en/docs/platform-model/balance-transfers.md): How to initiate balance transfers between your Platform Merchant account and sub-merchant accounts using the KOMOJU API, with fund flow illustrations for each direction. - [Payouts Overview](https://docs.komoju.com/en/docs/platform-model/payouts-overview.md): How Platform Merchants can configure payout frequency and minimum settlement amounts for themselves and their sub-merchants via the KOMOJU API and Dashboard. - [Sub-merchant Management](https://docs.komoju.com/en/docs/platform-model/sub-merchant-management.md): How Platform Merchants can manage and monitor their sub-merchants, including viewing account lists, details, payments, balances, transaction records, settlements, and downloading reports. - [Account Management](https://docs.komoju.com/en/docs/platform-model/account-management.md): How Platform Merchants can manage and monitor their own account, including viewing payments, balances, transaction records, settlements, and downloading reports via the KOMOJU API and Dashboard. - [Webhooks in the Platform Model](https://docs.komoju.com/en/docs/platform-model/webhooks-in-the-platform-model.md): An overview of webhook events available to Platform Merchants, covering events for both the Platform Merchant account and sub-merchant accounts, with an example delivery payload. ## Other - [v.2025-01-28](https://docs.komoju.com/en/docs/changelog/2025-01-28-unstable-more-details-in-responses-of-settlements-api-endpoints.md): In API version v.2025-01-28, we’ve improved how partial captures are represented, expanded the available information on settlements (including a revamped CSV and XLS format), and introduced updates for Platform Model. - [GrabPay Onboarding Deprecation](https://docs.komoju.com/en/docs/changelog/2026-01-06-grabpay-onboarding-deprecation.md): Removed GrabPay from onboarding forms following partner PPRO's sunset notice. - [Introducing API Versioning](https://docs.komoju.com/en/docs/changelog/2025-01-14-introducing-api-versioning.md): We're introducing API Versioning to improve flexibility and reliability—find out more in this changelog post. - [v.2026-01-27](https://docs.komoju.com/en/docs/changelog/2026-01-27-v2026-01-27.md): In API version v.2026-01-27 we have adjusted how the api/v1/payments endpoint calculates tax. - [Apple Pay Expanded to API Merchants](https://docs.komoju.com/en/docs/changelog/2026-01-14-apple-pay-expanded-to-api-merchants.md): Apple Pay is now available to merchants using direct API integrations, in addition to Hosted Page, WooCommerce, and Hosted Fields. - [One-Click Address Collection on Payment Links](https://docs.komoju.com/en/docs/changelog/2026-02-04-one-click-address-collection-on-payment-links.md): Merchants can now collect a customer's address on a Payment Link with a single click, instead of setting up manual custom text fields. - [Balances & Payouts Merchant UI](https://docs.komoju.com/en/docs/changelog/2026-02-25-balances-and-payouts-merchant-ui.md): Redesigned Balances & Payouts page combining payout and settlement views, with more detail on past and upcoming payouts. - [Subsidized SMB Pricing for Face-to-Face Payments](https://docs.komoju.com/en/docs/changelog/2026-03-09-subsidized-smb-pricing-for-face-to-face-payments.md): Small and medium physical-store merchants using KOMOJU terminals can now access a subsidized card rate of 2.4%, down from the standard 2.88% or 3.2%. - [3D Secure Challenge Fallbacks for High-Risk Card Payments](https://docs.komoju.com/en/docs/changelog/2026-04-16-3d-secure-challenge-fallbacks-for-high-risk-card-payments.md): High-risk card transactions no longer get an automatic rejection; instead, a 3D Secure challenge is triggered, and only transactions that pass proceed. - [Merpay Eligibility Extended to Sole Proprietors](https://docs.komoju.com/en/docs/changelog/2026-04-15-merpay-eligibility-extended-to-sole-proprietors.md): Merpay is now available to sole proprietors, in addition to corporations. - [Duplicate Payment Links](https://docs.komoju.com/en/docs/changelog/2026-04-28-duplicate-payment-links.md): Merchants can duplicate an existing Payment Link; all details copy over except the title, which gets an auto-appended '(1)'. - [PayPay Intermediate Page Deprecation (Shopify)](https://docs.komoju.com/en/docs/changelog/2026-05-21-paypay-intermediate-page-deprecation-shopify.md): Removed the intermediate confirmation page shown before redirecting to PayPay on Shopify checkouts. - [Official WooCommerce Partnership & Core Plugin Launch](https://docs.komoju.com/en/docs/changelog/2026-07-28-official-woocommerce-partnership-and-core-plugin-launch.md): KOMOJU is now an official WooCommerce partner, with the KOMOJU plugin live on WooCommerce.com for direct installation. - [Payment Links Core UX Improvements](https://docs.komoju.com/en/docs/changelog/2026-06-05-payment-links-core-ux-improvements.md): Payment Links now support link duplication, auto-opening QR/URL popup after creation, standardized UI patterns, and distinct navigation. - [3D Secure Authentication Migration to Netcetera](https://docs.komoju.com/en/docs/changelog/2026-08-01-3ds-authentication-netcetera-migration.md): KOMOJU has moved its 3D Secure authentication to Netcetera in live and test mode, with no merchant changes required. - [Chargeback Management Tool and API](https://docs.komoju.com/en/docs/changelog/2026-08-19-chargeback-management-tool-and-api.md): View disputes, accept chargebacks, and submit defense documentation from the Merchant Dashboard or through the API. - [Chargeback Custom Reporting](https://docs.komoju.com/en/docs/changelog/2026-06-08-chargeback-custom-reporting.md): Custom reports inside the Merchant Dashboard to track ongoing disputes, dispute win rates, and pending collection data. - [Dedicated Error Code for Insufficient Refund Balances](https://docs.komoju.com/en/docs/changelog/2026-09-04-insufficient-balance-refund-error.md): The refund endpoint now returns an insufficient_balance error code when your account does not have enough funds to cover a refund. - [WooCommerce Plugin v3.3.3: Checkout Descriptions and Callback Fixes](https://docs.komoju.com/en/docs/changelog/2026-09-09-woocommerce-plugin-update-3-3-3.md): Version 3.3.3 of the KOMOJU WooCommerce plugin shows custom payment method descriptions on classic checkout and fixes delayed webhook callbacks. - [Google Pay 3DS Authentication and Card Network Filtering](https://docs.komoju.com/en/docs/changelog/2026-08-31-google-pay-card-filtering.md): Google Pay now shows only the card brands enabled on the merchant account and routes payments through full 3D Secure challenges. - [Financial Summary Page Replaces Legacy Reports](https://docs.komoju.com/en/docs/changelog/2026-09-02-financial-summary-page.md): A new Financial Summary page replaces the legacy Reports view, with overview cards, pre-calculated totals, and terminology that matches settlement CSV exports. - [WeChat Pay In-Store Applications for Physical Terminals](https://docs.komoju.com/en/docs/changelog/2026-09-10-wechat-pay-instore-applications.md): Merchants using KOMOJU Terminal can now apply for in-store WeChat Pay acceptance from the dashboard. - [Zero-Amount Authorization for Card Verification](https://docs.komoju.com/en/docs/changelog/2026-09-14-zero-amount-card-verification.md): KOMOJU now verifies saved cards with a 0 JPY authorization instead of 1 JPY, following Visa and Mastercard guidelines. - [Redesigned Settlement Details and Invoices Pages](https://docs.komoju.com/en/docs/changelog/2026-09-15-redesigned-settlement-details-and-invoices-pages.md): The Settlement Details and Invoices pages in the Merchant Dashboard have a new layout, with full payout breakdowns, invoice previews, and bulk downloads. - [Subscriptions API: Fixed Billing Dates and Proration](https://docs.komoju.com/en/docs/changelog/2026-09-24-subscriptions-fixed-billing-dates-and-proration.md): Subscriptions can now bill every customer on a fixed day, with an optional prorated first charge for customers who join mid-cycle. - [Auto-Expiring Payment Links](https://docs.komoju.com/en/docs/changelog/2026-06-09-auto-expiring-payment-links.md): Payment Links can now be set to automatically disable after a maximum number of payments or a specific expiration date. - [Selectable Payment Methods on Payment Links](https://docs.komoju.com/en/docs/changelog/2026-07-22-selectable-payment-methods-on-payment-links.md): Merchants can restrict a Payment Link to a subset of their active payment methods (e.g., card only) instead of offering all of them. ## API Reference - [KOMOJU API Reference (2025-01-28)](https://docs.komoju.com/en/api-reference/2025-01-28/index.md): Full featured access to the KOMOJU payments system. - [Payments](https://docs.komoju.com/en/api-reference/2025-01-28/resources/payments.md): A **Payment** represents a single charge against a customer for a specific amount in a specific currency. - [Sessions](https://docs.komoju.com/en/api-reference/2025-01-28/resources/sessions.md): A **Session** is a hosted checkout experience that walks a customer through selecting a payment method and completing a payment. - [Tokens](https://docs.komoju.com/en/api-reference/2025-01-28/resources/tokens.md): A **Token** is a reusable, PCI-safe reference to a customer's credit card. - [Secure Tokens](https://docs.komoju.com/en/api-reference/2025-01-28/resources/secure-tokens.md): A **Secure Token** is a 3-D Secure–authenticated token that carries the result of a strong customer authentication challenge. - [Subscriptions](https://docs.komoju.com/en/api-reference/2025-01-28/resources/subscriptions.md): A **Subscription** charges a customer on a recurring schedule using a stored credit card token. - [Chargebacks](https://docs.komoju.com/en/api-reference/2025-01-28/resources/chargebacks.md): A **Chargeback** is a customer-initiated dispute against a card payment. - [Events](https://docs.komoju.com/en/api-reference/2025-01-28/resources/events.md): An **Event** is an immutable record of something that happened in your KOMOJU account — a payment being captured, a chargeback being filed, a subscription renewing, and so on. - [Settlements](https://docs.komoju.com/en/api-reference/2025-01-28/resources/settlements.md): A **Settlement** is a periodic accounting record that summarizes payments, refunds, and fees for a given settlement period. - [Platform](https://docs.komoju.com/en/api-reference/2025-01-28/resources/platform-model.md): The **Platform** endpoints power marketplaces and platforms built on top of KOMOJU. - [One Click](https://docs.komoju.com/en/api-reference/2025-01-28/resources/one-click.md): The **One Click** endpoints let a returning customer complete a purchase without re-entering payment details. - [Barcodes](https://docs.komoju.com/en/api-reference/2025-01-28/resources/barcodes.md): The **Barcodes** endpoint returns the barcode or QR code image for a payment method that requires the customer to pay at a physical location (for example, a konbini or a bank ATM). - [KOMOJU API Reference (2024-07-15)](https://docs.komoju.com/en/api-reference/2024-07-15/index.md): Full featured access to the KOMOJU payments system. - [Payments](https://docs.komoju.com/en/api-reference/2024-07-15/resources/payments.md): A **Payment** represents a single charge against a customer for a specific amount in a specific currency. - [Sessions](https://docs.komoju.com/en/api-reference/2024-07-15/resources/sessions.md): A **Session** is a hosted checkout experience that walks a customer through selecting a payment method and completing a payment. - [Tokens](https://docs.komoju.com/en/api-reference/2024-07-15/resources/tokens.md): A **Token** is a reusable, PCI-safe reference to a customer's credit card. - [Secure Tokens](https://docs.komoju.com/en/api-reference/2024-07-15/resources/secure-tokens.md): A **Secure Token** is a 3-D Secure–authenticated token that carries the result of a strong customer authentication challenge. - [Subscriptions](https://docs.komoju.com/en/api-reference/2024-07-15/resources/subscriptions.md): A **Subscription** charges a customer on a recurring schedule using a stored credit card token. - [Events](https://docs.komoju.com/en/api-reference/2024-07-15/resources/events.md): An **Event** is an immutable record of something that happened in your KOMOJU account — a payment being captured, a chargeback being filed, a subscription renewing, and so on. - [Settlements](https://docs.komoju.com/en/api-reference/2024-07-15/resources/settlements.md): A **Settlement** is a periodic accounting record that summarizes payments, refunds, and fees for a given settlement period. - [Platform](https://docs.komoju.com/en/api-reference/2024-07-15/resources/platform-model.md): The **Platform** endpoints power marketplaces and platforms built on top of KOMOJU. - [One Click](https://docs.komoju.com/en/api-reference/2024-07-15/resources/one-click.md): The **One Click** endpoints let a returning customer complete a purchase without re-entering payment details. - [Barcodes](https://docs.komoju.com/en/api-reference/2024-07-15/resources/barcodes.md): The **Barcodes** endpoint returns the barcode or QR code image for a payment method that requires the customer to pay at a physical location (for example, a konbini or a bank ATM).