# Waffo Documentation: Japanese

## Japanese

### ガイド

#### 製品とサービス

- [Waffo製品概要](https://waffo.com/docs/ja/essentials/product-overview.md): グローバル決済インフラの構築。アクワイアリングから成長までを網羅するフルスタックソリューション。

#### 決済・支払い

- [チェックアウト](https://waffo.com/docs/ja/essentials/checkout.md): Waffoの標準化されたチェックアウト製品。ワンタイム決済とサブスクリプション決済のグローバルな決済インタラクションフローを一元的に管理します。
- [ワンタイム決済](https://waffo.com/docs/ja/essentials/one-time-payment.md): 一度の連携で、世界主要な決済手段に対応。すべての取引を、明確にコントロール。
- [サブスクリプションと継続課金](https://waffo.com/docs/ja/essentials/subscription-recurring.md): 継続決済シナリオ向けに、自動化された高成功率の課金ソリューションを提供します。一度の承認で複数回の自動引き落としを行うメカニズムを通じて、柔軟な課金サイクル設定とスマートリトライをサポートします。
- [決済手段](https://waffo.com/docs/ja/essentials/payment-methods.md): 単一の統一APIインターフェースを通じて、グローバル主流およびユニークなローカル決済手段にビジネスを接続します。

#### 精算・資金

- [加盟店精算](https://waffo.com/docs/ja/essentials/merchant-settlement.md): インテリジェントで透明性の高いグローバル資金精算サービス。多通貨取引を自動で換算し、柔軟な精算戦略によって加盟店のキャッシュフローを的確に最適化します。
- [加盟店ポータル](https://waffo.com/docs/ja/essentials/merchant-portal.md): クロスボーダー企業向けのワンストップ決済管理プラットフォーム。取引、精算、分析、チームアクセスを一箇所で管理できます。

#### 付加価値サービス

- [ディスピュートとチャージバック](https://waffo.com/docs/ja/essentials/dispute-chargeback.md): チャージバックアラート、カスタマーディスピュート、チャージバックの3つのコアステージを網羅する、体系的で階層的なクローズドループ防衛システム。
- [データインテリジェンス](https://waffo.com/docs/ja/essentials/data-intelligence.md): 不明瞭な銀行コードを実行可能な成長戦略に変換するエンドツーエンドのデータインテリジェンス。

#### 高度な機能

- [トークナイゼーション](https://waffo.com/docs/ja/essentials/tokenization.md): Waffoトークンを使用して決済情報を安全に保存し、生のカード番号を扱うことなく、ワンクリック決済、継続課金、遅延請求を実現します。
- [Auth-Capture](https://waffo.com/docs/ja/essentials/auth-capture.md): 決済を2段階に分割—事前に資金をオーソリし、取引確定時にのみキャプチャすることで、不正リスクと返金コストを削減します。

#### ポイントチャージ

- [ポイントチャージ](https://waffo.com/docs/ja/essentials/point-topup.md): Waffo Point Topup は、ポイントカードチャージ API およびホワイトラベル型ポイントカードチャージソリューションです。サプライヤーは API 連携または URL リダイレクトで自社のポイントコード在庫やチャージ機能を接続でき、ストアフロントや決済の構築は不要です。

### 開発者ドキュメント

#### はじめに

- [統合の概要](https://waffo.com/docs/ja/developer-docs/getting-started/overview.md): ワンストップ型グローバル決済プラットフォームとしてのWaffoのコア機能と統合フローの概要。
- [統合ガイド](https://waffo.com/docs/ja/developer-docs/getting-started/quickstart.md): 5分で最初の決済を完了し、Waffo Paymentsを素早く統合します。
- [サンドボックスとテスト](https://waffo.com/docs/ja/developer-docs/getting-started/sandbox.md): 実際の資金を使用せずに、サンドボックス環境で完全な統合テストを実施します。
- [本番移行チェックリスト](https://waffo.com/docs/ja/developer-docs/getting-started/go-live.md): サンドボックスから本番環境へ切り替える前の完全なチェックリスト。

#### コアコンセプト

- [決済ライフサイクルと注文ステータス](https://waffo.com/docs/ja/developer-docs/core-concepts/payment-lifecycle.md): Waffo の決済注文、サブスクリプション、返金のステータス遷移について解説します。
- [金額と通貨](https://waffo.com/docs/ja/developer-docs/core-concepts/currency.md): Waffo の金額フォーマット仕様とマルチ通貨決済のガイド。
- [価格通貨戦略](https://waffo.com/docs/ja/developer-docs/use-cases/pricing-currency.md): Waffoがサポートする3つの価格通貨戦略(グローバル統一価格、国別価格、地域別価格)の概要と、正しいパラメータの渡し方。
- [エラーハンドリング](https://waffo.com/docs/ja/developer-docs/core-concepts/error-handling.md): Waffo API のエラーコード分類と、ステータス不明例外の処理方法についてのガイド。
- [冪等性](https://waffo.com/docs/ja/developer-docs/core-concepts/idempotency.md): 冪等キーを使用して二重課金を防止し、決済の安全性を確保します。

#### インテグレーション

- [統合方式の選択](https://waffo.com/docs/ja/developer-docs/use-cases/checkout-solution.md): Waffoの2つのチェックアウト統合モードを比較し、適切な統合方式を選択します。
- [Coupon の設定と利用](https://waffo.com/docs/ja/developer-docs/use-cases/coupons.md): Coupon を有効化し、Merchant Portal で Promotion Code を設定して、API または Waffo Checkout から割引を適用します。
- [AI 連携ツール（waffo-integrate）](https://waffo.com/docs/ja/developer-docs/integration/ai-integration.md): AI コーディングツールで Waffo SDK 連携を自動化し、検証します。
- [Checkout 連携 - 連携手順](https://waffo.com/docs/ja/developer-docs/integration/checkout/steps.md): Waffo ホスト型 Checkout を使用した決済連携の完全な手順。
- [Cashier 連携 - カスタマイズオプション](https://waffo.com/docs/ja/developer-docs/integration/checkout/customization.md): Cashier の決済手段フィルタリング、多通貨、言語、テーマカスタマイズなどの設定。
- [Merchant Portal Cashier カスタマイズ](https://waffo.com/docs/ja/developer-docs/integration/checkout/portal-customization.md): Merchant Portal で Cashier のロゴ、テーマスタイル、サブ加盟店スタイル、公開ルール、権限を設定します。
- [x402 ステーブルコイン決済](https://waffo.com/docs/ja/developer-docs/use-cases/x402-stablecoin-acquiring.md): x402 プロトコルで AI エージェントからの USDC ステーブルコイン決済を受け入れる：加盟店ホスト型 402 と Waffo ホスト型の 2 つの統合モードの完全ガイド。

##### Subscription ユースケース

- [シートを追加して差額を請求](https://waffo.com/docs/ja/developer-docs/use-cases/subscription-use-cases.md): Subscription の当期差額請求で使用する主要フィールドを説明します。

##### Apple Pay の連携

- [Apple Pay の連携](https://waffo.com/docs/ja/developer-docs/integration/apple-pay/overview.md): 4 つの Apple Pay 連携方式と、実行環境、フロントエンド、トークン処理に関する各方式の要件を比較します。
- [Merchant が Apple Pay と直接連携する](https://waffo.com/docs/ja/developer-docs/integration/apple-pay/merchant-direct-integration.md): Merchant サーバーで Apple Pay トークンを復号し、Waffo 指定の形式で復号結果を送信します。

##### APIのみの統合

- [概要](https://waffo.com/docs/ja/developer-docs/integration/api/overview.md): ワンタイム決済とサブスクリプション決済の手動API統合ロードマップ。
- [コード例](https://waffo.com/docs/ja/developer-docs/integration/api/examples.md): Node.js、Java、Go、Python、raw HTTP 向けの多言語 API 連携コード例。

##### Elements（フロントエンド SDK）

- [フロントエンドコンポーネント - コンポーネントの使い方](https://waffo.com/docs/ja/developer-docs/integration/elements/usage.md): フロントエンドコンポーネントを連携して、加盟店ページに決済機能を埋め込む方法。
- [フロントエンドコンポーネント - スタイルカスタマイズ](https://waffo.com/docs/ja/developer-docs/integration/elements/styling.md): Cashier の外観、言語、決済手段フィルタリングに関するカスタマイズオプション。

##### カード登録・トークン

- [カードバインドとトークン管理](https://waffo.com/docs/ja/developer-docs/integration/tokenization/overview.md): ユーザーの銀行カード情報を安全にトークン化し、以降の決済時にカード番号の再入力を不要にします。

##### Settlement & Reconciliation

- [Reconciliation reports](https://waffo.com/docs/ja/developer-docs/tools-and-references/references/reconciliation-reports.md): Waffo Reconciliation reports の定義、CSV フィールド、ファイル名、例を説明します。

#### Webhook

- [Webhook - 概要と設定](https://waffo.com/docs/ja/developer-docs/webhook/overview.md): Waffo Webhook による非同期イベント通知の概要と設定要件。
- [Webhook - イベントタイプ一覧](https://waffo.com/docs/ja/developer-docs/webhook/event-types.md): Waffo Webhook の全イベントタイプの詳細な説明とペイロード例。
- [Webhook - 署名検証](https://waffo.com/docs/ja/developer-docs/webhook/signature-verification.md): Webhook リクエストの RSA 署名検証方法とコード例。
- [Webhook - 処理のベストプラクティス](https://waffo.com/docs/ja/developer-docs/webhook/best-practices.md): Webhook 処理のベストプラクティス: 冪等性、高速応答、セキュリティなど。
- [Webhook - 再送と障害復旧](https://waffo.com/docs/ja/developer-docs/webhook/retry.md): Webhook の再送メカニズムと障害復旧戦略。

#### SDK

- [Node.js SDK](https://waffo.com/docs/ja/developer-docs/sdk/nodejs.md): Waffo Node.js SDK のインストール、初期化、および利用ガイド。
- [Java SDK](https://waffo.com/docs/ja/developer-docs/sdk/java.md): Waffo Java SDK のインストール、初期化、および利用ガイド。
- [Go SDK](https://waffo.com/docs/ja/developer-docs/sdk/go.md): Waffo Go SDK のインストール、初期化、および利用ガイド。
- [Python SDK](https://waffo.com/docs/ja/developer-docs/sdk/python.md): Waffo Python SDK のインストール、初期化、および利用ガイド。
- [PHP SDK](https://waffo.com/docs/ja/developer-docs/sdk/php.md): Waffo PHP SDK のインストール、初期化、および利用ガイド。
- [SDK 変更履歴](https://waffo.com/docs/ja/developer-docs/sdk/changelog.md): Waffo Node.js、Java、Go、Python、PHP SDK のリリース変更履歴。

#### ツールとリファレンス

##### 開発者ツール

- [Postman コレクション](https://waffo.com/docs/ja/developer-docs/tools-and-references/developer-tools/postman.md): Postman コレクションを使用して Waffo API を素早くテストします。
- [サンドボックスシミュレーター](https://waffo.com/docs/ja/developer-docs/tools-and-references/developer-tools/sandbox-simulator.md): サンドボックス環境でさまざまな決済シナリオをシミュレートするための説明。
- [Octopus サンドボックステスト決済](https://waffo.com/docs/ja/developer-docs/tools-and-references/developer-tools/octopus-sandbox-e2e.md): Octopus テストアプリの手順に沿って、サンドボックス決済テストを完了します。

##### リファレンス

- [エラーコードクイックリファレンス](https://waffo.com/docs/ja/developer-docs/tools-and-references/developer-tools/error-codes.md): Waffo API のエラーコードとカテゴリの完全なリスト。
- [データリファレンス](https://waffo.com/docs/ja/developer-docs/tools-and-references/references/data-reference.md): Waffo のステータスコード、列挙値、決済手段タイプ、共通規約の完全なリファレンス。
- [よくあるご質問 (FAQ)](https://waffo.com/docs/ja/developer-docs/tools-and-references/references/faq.md): Waffo の連携、決済、セキュリティに関するよくある質問と回答。
- [決済手段別の連携注意事項](https://waffo.com/docs/ja/developer-docs/tools-and-references/references/payment-method-integration-notes.md): Checkout 連携における決済手段と利用環境ごとの注意事項。
- [決済手段別サブスクリプション比較](https://waffo.com/docs/ja/developer-docs/tools-and-references/references/subscription-payment-methods.md): 決済手段ごとのサブスクリプションの違い（課金モデル、頻度、トライアル期間、管理）をまとめます。
- [連携受け入れ基準](https://waffo.com/docs/ja/developer-docs/tools-and-references/references/acceptance-criteria.md): 加盟店が Waffo 連携完了後に満たすべき受け入れ基準。機能テスト、例外処理、パラメーター要件、データ完全性を含みます。
- [API バージョン履歴](https://waffo.com/docs/ja/developer-docs/tools-and-references/references/changelog.md): Waffo API のバージョン履歴と変更履歴。

#### ポイントチャージ API

- [ポイントチャージ連携の概要](https://waffo.com/docs/ja/developer-docs/point-topup/overview.md): サプライヤー向け Waffo Point Topup の3つの連携モード、エンドポイントの提供元、およびモード別の準備チェックリスト。
- [モード A：オフラインポイントコードインポート](https://waffo.com/docs/ja/developer-docs/point-topup/mode-a-offline-import.md): サプライヤーが Excel/CSV でポイントコードをオフライン提供し、Waffo Point Topup が在庫にインポートして販売と発送を代行します。API 開発は不要です。
- [モード B：ポイントコード取得 API](https://waffo.com/docs/ja/developer-docs/point-topup/mode-b-point-code-api.md): ユーザーが支払いを完了した後、Waffo Point Topup がサプライヤーのポイントコード取得 API をリアルタイムで呼び出します。リクエスト・レスポンス項目、冪等性の要件、サンプル。
- [モード C：即時履行 API](https://waffo.com/docs/ja/developer-docs/point-topup/mode-c-direct-fulfillment.md): URL 署名リダイレクト、即時履行、即時履行結果照会、履行結果通知 Webhook。ユーザーが支払いを完了した後、Waffo Point Topup がサプライヤーのエンドポイントを呼び出してユーザーアカウントを直接チャージします。
- [ポイントチャージ API 共通仕様](https://waffo.com/docs/ja/developer-docs/point-topup/api-common.md): Waffo Point Topup とサプライヤー間のインターフェース規約、メッセージ構造、SHA256WithRSA 署名と検証、エラーコード、RSA 鍵の生成。

### API リファレンス

#### 概要

- [概要](https://waffo.com/docs/api-reference/ja/introduction.md): Waffo アクワイアリング注文 API リファレンス

#### 都度決済

- [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 cancel](https://waffo.com/docs/api-reference/order-cancel/order-cancel.md)
- [Order refund](https://waffo.com/docs/api-reference/order-refund/order-refund.md)
- [Refund inquiry](https://waffo.com/docs/api-reference/refund-inquiry/refund-inquiry.md)
- [Order capture](https://waffo.com/docs/api-reference/order-capture/order-capture.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 cancel](https://waffo.com/docs/api-reference/subscription-cancel/subscription-cancel.md)
- [Subscription manage](https://waffo.com/docs/api-reference/subscription-manage/subscription-manage.md)
- [Subscription change](https://waffo.com/docs/api-reference/subscription-change/subscription-change.md)
- [Subscription change inquiry](https://waffo.com/docs/api-reference/subscription-change-inquiry/subscription-change-inquiry.md)
- [Subscription update](https://waffo.com/docs/api-reference/subscription-update/subscription-update.md)

#### 設定

- [Merchant Config inquiry](https://waffo.com/docs/api-reference/merchant-config-inquiry/merchant-config-inquiry.md)
- [Pay Method Config Inquiry](https://waffo.com/docs/api-reference/pay-method-config-inquiry/pay-method-config-inquiry.md)
- [Wallet inquiry](https://waffo.com/docs/api-reference/wallet-inquiry/wallet-inquiry.md): Query on-chain wallet / receiving address (network/asset/payTo) for x402 stablecoin payin

#### チャージバック

- [Chargeback inquiry](https://waffo.com/docs/api-reference/chargeback-inquiry/chargeback-inquiry.md): Query a single chargeback by chargebackId or originalOrderId. Note: when the original order has more than one chargeback, for example after escalation to Second Cycle, query by chargebackId.
- [Chargeback list](https://waffo.com/docs/api-reference/chargeback-list/chargeback-list.md): Query chargebacks by creation time range, status and life cycle. Note: this API does not return the message and evidence objects; use Chargeback inquiry to retrieve them.
- [Chargeback accept](https://waffo.com/docs/api-reference/chargeback-accept/chargeback-accept.md): Accept the chargeback. The amount and fee were already debited when the chargeback was created, so accepting does not trigger a further debit — the case is closed and the merchant is not refunded. Note: this action is irreversible — no further evidence can be submitted afterwards, and an ACCEPTED no…
- [Chargeback update](https://waffo.com/docs/api-reference/chargeback-update/chargeback-update.md): Submit defense evidence in First Cycle, or defend the case in Second Cycle. Note: in First Cycle at least one evidence file is required, supplied through message.documents or evidence.othersFile; in Second Cycle the call itself defends the case and evidence is not accepted. On success the status bec…
- [Chargeback file upload](https://waffo.com/docs/api-reference/chargeback-file-upload/chargeback-file-upload.md): Upload an evidence file and obtain the fileId used by the Chargeback update API. Send the request as multipart/form-data. Note: this API is authenticated by X-API-KEY only and does not participate in RSA signing; the response carries no X-SIGNATURE. The merchantId must match the merchant bound to th…
- [Chargeback file download](https://waffo.com/docs/api-reference/chargeback-file-download/chargeback-file-download.md): Download a previously uploaded evidence file. On success the API returns HTTP 302 Found with a Location header pointing to a time-limited pre-signed URL; the file content is served from that URL, so the HTTP client must follow redirects (curl requires -L). This API does not stream the file bytes dir…
- [Reported Fraud list](https://waffo.com/docs/api-reference/reported-fraud-list/reported-fraud-list.md): Query the fraud reports the card schemes raised against your transactions, filtered by fraud report date, card scheme and acquiring order Id.  Reported fraud is the card scheme's own fraud signal and is independent of chargebacks: a reported transaction may never be charged back, and a chargeback ma…

#### トークナイゼーション

- [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)

#### Payout

- [Payout create](https://waffo.com/docs/api-reference/payout-create/payout-create.md)
- [Payout inquiry](https://waffo.com/docs/api-reference/payout-inquiry/payout-inquiry.md)

#### ポイントチャージ

- [Signed redirect to checkout](https://waffo.com/docs/api-reference/point-topup-redirect/signed-redirect-to-checkout.md): Hands an end user from the supplier's site to the Waffo Point Topup storefront. Waffo validates the required parameters, checks that `timestamp` is within 2 hours, recalculates the signature, issues a session token and then redirects the user to the `siteCode` purchase page.
- [Fulfillment inquiry](https://waffo.com/docs/api-reference/point-topup-fulfillment-inquiry/fulfillment-inquiry.md): Lets the supplier query the fulfillment result of a Mode C order from Waffo Point Topup. This is the pull-based counterpart of the fulfillment event webhook, typically used for reconciliation or when a webhook notification was missed.
- [履行結果 Webhook](https://waffo.com/docs/api-reference/ja/point-topup-fulfillment-webhook.md): Waffo Point Topup がサプライヤー自身のエンドポイントに Mode C 注文の最終履行ステータスを通知する Webhook。

## OpenAPI Specs

- [openapi](/docs/api-reference/openapi.json)
- [tokenization-api](/docs/api-reference/tokenization-api.json)
- [point-topup-api](/docs/api-reference/point-topup-api.json)