> ## Documentation Index > Fetch the complete documentation index at: https://waffo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Payin 契約と取引限度額 > Service → Payin の読み方：Payin 契約一覧の各列、手数料と精算サイクルの表記、契約ステータス、金額の上限——さらに 2 つの限度額超過エラーの意味、日次限度額のカウント方法と解放タイミング、チェックアウトでユーザーに表示される名前。 **Service → Payin** は、お客様が実際に受け付ける契約を結んでいる内容——どの決済手段を、どの国と 通貨で、どの手数料基準で、どの金額上限と返金ルールのもとで——を記録した Portal のページです。 このページでは、その読み方と、決済がそれらの限度額のいずれかに達したときに何が起きるかを説明します。 注文作成そのものは [Order Create フィールドガイド](/docs/ja/support/order-create-field-guide)で、返金の挙動は [返金 FAQ](/docs/ja/support/refund-faq)で、チェックアウト画面がユーザーに何を表示するかは [チェックアウト表示ルール](/docs/ja/support/cashier-display-rules-faq)で説明しています。 ## 契約している決済手段はどこで確認できますか？ **Service → Payin** です。契約済みの組み合わせごとに 1 行あり、列は次のとおりです： | 列 | 内容 | | - | - | | `Payment Method Country` | その決済手段が適用される国または地域 | | `Product` | その行が属する商品（例：ワンタイム決済またはサブスクリプション商品） | | `Payment method type` | カテゴリ——カード、ウォレット、銀行振込など | | `Payment method` | 具体的な決済手段（ロゴ付き） | | `Payment option` | 決済手段がオプションごとに異なる料金設定を持つ場合のサブ行 | | `Fees` | その行の手数料基準——後述 | | `User Fee` | 少なくとも 1 行で支払者に手数料を課している場合のみ表示——後述 | | `Settlement cycle` | `T+3` のような表記——後述 | | `Minimum amount` | その行で受け付ける最小注文金額 | | `Maximum amount` | その行で受け付ける最大注文金額 | | `Order Currency` | 注文が作成される通貨 | | `User Currency` | 支払者に請求される通貨 | | `Refundable` | その行で許可される返金の形態——後述 | | `Refund Period` | 決済後、返金が可能な期間 | | `Additional Fields For Refunds` | この行の返金に追加フィールドが必要かどうか | | `Order Expiry Customization` | その行がカスタム注文有効期限をサポートする場合のみ表示 | | `Status` | その行の契約状態 | | `Mini Apps Info` | その行にミニアプリ情報が存在する場合のみ表示 | `Fees` と `Settlement cycle` はすべての契約タイプで表示されるわけではありません——お客様のページに なければ、それは契約の形態によるもので、権限が欠けているわけではありません。 バックエンドが提供しないものは空欄のままではなく `-` として表示されます。したがってダッシュは 「この行には何も設定されていない」という意味であり、「ゼロ」ではありません。 ## Fees 列はどう読めばよいですか？ Fees セルは単一の数値ではなく、複合的なものです。最大 4 つの部分から組み立てられます： | 表示される形 | 読み方 | | - | - | | `% ` | 金額に対するパーセンテージのみ | | ` ` | 取引ごとの固定金額のみ | | `%+ ` | 両方——パーセンテージと固定金額 | | `… (min )` | 下限：手数料はこの金額を下回りません | | `… (max )` | 上限：手数料はこの金額を上回りません | | `… (min , max )` | 下限と上限の両方 | 上限が固定金額ではなく比率で表現される場合、`max` 部分は代わりにパーセンテージで表示されます。 さらに 2 つの詳細： * 列ヘッダーにはツールチップ **"Rounding up to 2 decimal places per transaction."** が付いています—— 端数処理は精算バッチごとに 1 回ではなく、取引ごとに適用されます。 * 決済手段が決済オプションごとに異なる料金設定を持つ場合、行はオプションごとに 1 行の手数料行に 展開されます。オプションごとの有意な区別がない決済オプションは `-` として表示されます。 実際の料率は商業上の条件であり、お客様ご自身のページにのみ表示されます——どこにも公開されていません。 ## User Fee 列とは何ですか？なぜ表示されないのですか？ `User Fee` は、そのような仕組みの決済手段において、お客様ではなく**支払者**が負担する手数料です。 この列は**条件付き**です：Portal は、お客様のページの少なくとも 1 行が実際にユーザー手数料を 持っている場合にのみ、この列を表示します。該当する行がなければ列は表示されません——何かが隠されて いるわけではありません。 そのヘッダーのツールチップは **"Fees charged to end users."** です。 ユーザー手数料が存在する場合、その行の `Refundable` セルには、返金時にその手数料がどうなるかを 示す 2 行目が追加されます： | 2 行目 | 意味 | | - | - | | `User fee refundable`（緑のチェック） | ユーザー手数料は返金の一部として返還されます | | `User fee not refundable`（黄色の警告） | ユーザー手数料は返還されません | これは、ユーザーに返金総額を提示する際に重要です：支払者の手数料とお客様の手数料は別々のルールに 従います。返金時のお客様ご自身の手数料の挙動は [返金 FAQ](/docs/ja/support/refund-faq)で説明しています。 ## T+3 のような精算サイクルはどういう意味ですか？ この表記は**サイクルの文字、`+`、数**で構成されます： | 文字 | サイクル | | - | - | | `T` | 日次 | | `W` | 週次 | | `H` | 半月次 | | `M` | 月次 | つまり `T+3` は遅延 3 の日次サイクル、`W+1` は遅延 1 の週次サイクル、`M+1` は月次サイクルです。 月次のバリエーションとして `M+1X` も表示されます。 日次の文字は `D` ではなく **`T`** であることに注意してください——自社システムにマッピングする場合、 `D` を前提にしないでください。サイクルが実際の支払いにどう変わるかは [精算サイクル](/docs/ja/support/settlement-cycle-faq)で説明しています。 ## 契約ステータスはそれぞれどういう意味ですか？ `Status` 列には 5 つの値のいずれかが色分けされて表示されます： | 表示されるステータス | 色 | | - | - | | `Active` | 緑 | | `Initial` | 黄 | | `Onboarding` | 黄 | | `Suspended` | 赤 | | `Terminated` | 赤 | 色を実務上のシグナルとして読んでください：緑は確定した稼働中の状態、黄はその行がまだ立ち上げ中で あること、赤は稼働していないことを意味します。Portal が認識しない値は隠されずにそのまま表示され、 空の値は `-` として表示されます。 取引を行う予定の行が緑でない場合は、連携のデバッグを始める前に Waffo の担当者に相談してください—— 契約状態は API からではなく Waffo 側で設定されます。 ## Refundable の値はそれぞれどういう意味ですか？ 4 つの値があり、これらは**形態**に関するものであって、個々の注文を今すぐ返金できるかどうかに 関するものではありません： | 値 | その行で許可されるもの | | - | - | | `No` | この決済手段では返金不可 | | `Only Full Refund` | 全額に対する 1 回の返金 | | `Full Refund or One-time Partial Refund` | 1 回の全額返金、または 1 回のみの一部返金 | | `Full Refund or Multiple Partial Refunds` | 全額返金、または複数回の一部返金 | 隣の `Refund Period` は、決済後に返金がまだ受け付けられる期間です。両方が Portal の注文ごとの 返金操作に反映されます—— [返金ボタンが表示されない、またはグレーアウトしているのはなぜですか？](/docs/ja/support/transaction-field-reference-faq) を参照してください。 ## このページにはどのフィルターがありますか？エクスポートはできますか？ 6 つのフィルターがあります：`Payment Method Country`、`Payment method type`、`Payment method`、 `Order Currency`、`User Currency`、`Status`。`Product` は**列であってフィルターではありません**—— 商品で絞り込むには、他のフィールドでフィルターをかけて Product 列を読んでください。 **Export** は現在のビューの CSV を生成します： | 挙動 | 詳細 | | - | - | | 範囲 | 現在フィルターで選択されているもの | | 行数上限 | エクスポートごとに最大 2,000 行 | | 配信 | すぐにダウンロードされます——キュー処理されるレポートエクスポートの一つではありません | | ヘッダー | バックエンドのヘッダー名で、画面上のラベルとすべて一致するわけではありません——特に通貨列は、画面では `Order Currency` と `User Currency` と表示されるところ、*acquiring currency* と *local currency* としてエクスポートされます | Portal の他の場所にあるキュー処理される非同期エクスポートは挙動が異なります。 [エクスポートとレポートのダウンロード](/docs/ja/support/export-center-faq)を参照してください。 ## 行の並び順が Payment Method Country 列と一致しないのはなぜですか？ 行は**国 → 決済手段タイプ → 決済手段名 → 商品**の昇順で並べられます。 細かい点：並び替えのキーは契約自体の国フィールドですが、最初の列に表示されるのは決済手段の国です。 ほとんどの行では両者は一致しますが、異なる場合、見えている順序はお読みになっている列を基準にした 厳密なアルファベット順には見えません。並び替えは結果のページごとにも適用されるため、ページ送りで 全体が再ソートされることはありません。 ## `Order Expiry Customization` 列は実際に何を教えてくれるのですか？ その行で**要求が許可されている注文有効期限の範囲**です——単一のデフォルト値ではありません。 決済手段がカスタム有効期限を受け付ける場合、セルには時間の範囲が表示されます。受け付けない場合、 セルには `-` が表示され、有効期限は契約で定められたものになります。 読み方を決める 2 つの詳細： * 表示される範囲は、その行がモバイルアプリで許可するものとデスクトップブラウザで許可するものの **共通部分**です。したがって、購入者がどの端末を使っていても安全な範囲です。行によっては、 ある端末に対して範囲が示すよりも寛容な場合があります。 * お客様のページの少なくとも 1 行にカスタマイズ可能な有効期限がなければ、列全体が**非表示**に なります。列がないことは「お客様の行はいずれもこれをサポートしていない」という意味であり、 権限が欠けているわけではありません。 ## 注文有効期限を自分で設定できますか？競合した場合はどちらが優先されますか？ `order/create` で `orderExpiredAt` を送信してください。省略すると契約の有効期限が適用されます—— これが文書化されたデフォルトです。 送信した値に何が起きるか： | 送信する値 | 結果 | | - | - | | なし | 契約の有効期限が適用されます | | すでに過去の時刻 | 値は**破棄され**、契約の有効期限が適用されます。注文は作成され、拒否はされません | | 数分先の時刻 | 送信どおりに受け付けられます。購入者が決済を完了するには時間が必要で、決済手段によっては他より多くの時間を要することに留意してください | | 行の許可範囲外の時刻 | 範囲を厳格な要件として扱い、範囲内に収めてください。範囲外の値を送信することは過去の値を送信することとは異なる状況であり、注文作成レスポンスはどちらが起きたかを教えてくれません | 読み違えないでほしいコードが 1 つあります：**`A0034`** は、注文に対する処理が行われる時点で、 指定した有効期限が**すでに期限切れになっている**場合に返されます。「有効期限が許可範囲外だった」 ことを示すコードではありません。 注文有効期限は、設定されると購入者の決済可能時間になります——それが終了したときに何が起きるか、 どの注文状態が最終であるかは [決済タイムアウトと確定性](/docs/ja/support/payment-timeout-and-finality-faq)にあります。 ## `Mini Apps Info` 列とは何ですか？ その行に登録されているウォレットのミニプログラムです。各エントリはミニアプリ名で、ホバーすると アプリの ID と名前が表示されます。この列はテーブルの右端に固定されており、**お客様のページの 少なくとも 1 行にミニアプリのエントリがある場合にのみ表示されます**——それ以外の場合は列自体が 存在せず、エントリのない行には `-` が表示されます。 ウォレットのミニプログラム内から決済を受け付ける場合にこれが必要になります。アプリ ID が、 決済手段に対してお客様のミニプログラムを識別するものだからです。商品（`MINI_PROGRAM_PAYMENT`）と 送信すべき端末値を含む連携そのものについては [ミニプログラム決済](/docs/ja/support/mini-program-payments-faq)にあります。 ## 注文が限度額超過で拒否されました。どの限度額ですか？ 限度額は 3 つあり、メッセージがどれかを教えてくれます： | メッセージ | エラーコード | 意味 | | - | - | - | | `Payment amount should be within the range` | `A0008` | 注文金額が **Service → Payin の行**の `Minimum amount` / `Maximum amount` の範囲外です——決済手段と通貨ごとの範囲 | | `Payment amount exceeds transaction limit.` | `A0020` | この**単一**の注文が、その**注文通貨**に対して設定された**アカウントレベル**の取引ごとの限度額を超えています。決済手段とは無関係です | | `Accumulative payment amount exceeds daily transaction limit.` | `A0021` | 注文は取引ごとの限度額の範囲内ですが、**その注文通貨での全決済手段をまたいだ日次合計**が上限を超えてしまいます | `A0008` については、注文金額を該当する Service → Payin の行と比較してください。`A0020` と `A0021` については、行を見るのは適切ではありません：これらの限度額は**加盟店 ID + 注文通貨**のみをキーと しているため、支払者を同じ通貨の別の決済手段に切り替えても解決せず、ある通貨の限度額を引き上げても 別の通貨には何の効果もありません。`A0021` では注文サイズではなく、その日が問題です。3 つとも注文 作成時に返されるため、注文が作成途中の状態で残ることはありません。 その注文通貨にアカウントレベルの限度額が設定されていない場合、`A0020` / `A0021` のチェックは 実行されず、どちらのエラーも発生しません。アカウントレベルの限度額は Service → Payin には 表示されません。知る必要がある場合は Waffo の担当者にお尋ねください。 ## 日次限度額は正確にどのようにカウントされ、いつ枠が解放されますか？ | 質問 | 回答 | | - | - | | どの日？ | **UTC+8 の暦日**。日の境界は `00:00 UTC+8` で、お客様の現地の深夜でも UTC でもありません | | 金額はいつカウントされる？ | **注文作成時**、注文が記録された直後——決済成功時ではありません | | どの注文がカウントされる？ | 進行中の注文**と**成功した注文 | | 枠はいつ解放される？ | 注文が**クローズ**状態に達したときのみ、かつ同じ UTC+8 の日に作成された注文の場合のみ | | 返金で枠は解放される？ | \*\*いいえ。\*\*成功した決済を返金しても、その日の枠は戻りません | 実務上の影響は 2 点です： * `00:00 UTC+8` の直前に作成され、その後に成功した注文は、**作成された**日に対してカウントされます。 * 放棄されたチェックアウトは、クローズするまで枠を消費します。上限付近で大量の注文をまとめて 処理している場合、差分を食いつぶしているのは通常これであり、成功した決済ではありません。 ## 自分が何もしなくても限度額が変わることはありますか？ はい。決済手段の基盤となるプロバイダーが限度額を改定した場合、Waffo はお客様の契約の限度額を 再計算し、新しい範囲が **Service → Payin** に表示されます。知っておくべき仕組みが 2 つあります： * プロバイダーの限度額がお客様の契約と異なる通貨で表現されている場合、適用前に換算されるため、 結果の数値が丸い数になることはほとんどありません。 * 端数処理は意図的に保守的です：**最小値は切り上げ**、**最大値は切り下げ**られるため、結果の範囲が 元の範囲より広くなることはありません。補助単位のない通貨——`JPY`、`KRW`、`VND` など——では、 最小値は整数単位になります。 新しい範囲外のリクエストは、変更が反映された時点から上記の 2 つのエラーで拒否されます。注文量が 限度額に近い場合は、連携内で値をキャッシュするのではなく、Service → Payin から値を読み取ってください。 ## 使用している決済手段が廃止されます。どのように通知されますか？ お客様の契約が終了すると、その決済手段を明記したメールが、加盟店アカウントの管理者および スーパー管理者ユーザーに送信されます。詳細： | 挙動 | 詳細 | | - | - | | トリガー | 契約行が `Terminated` に移行すること | | 受信者 | その時点で加盟店アカウントの Administrator または Super Administrator ロールを持つユーザー——つまり受信者は Portal のチーム管理でそれらのロールに割り当てられている人であり、固定の連絡先アドレスではありません | | 重複排除 | 加盟店ごと、決済手段ごとに 1 通で、契約行ごとに 1 通ではありません | | サンドボックス | サンドボックスでは送信されません | その後、Service → Payin でその行は赤で `Terminated` と表示され、その組み合わせでの新規注文は 拒否されます。既存の注文とその返金は、ステータス変更そのものによる影響を受けません。その決済手段が チェックアウトにとって重要な場合は、Waffo の担当者に代替を依頼してください——Portal には終了した 行を再度有効にするセルフサービスの手段はありません。 ## チェックアウトでユーザーに表示される加盟店名はどれですか？ チェックアウト画面には**表示名**が表示され、次の順序で解決されます： | ケース | 表示される名前 | | - | - | | 注文作成リクエストで表示名を明示的に渡した | その名前が以下のすべてに優先します | | 単一の加盟店アカウントで、表示名が設定されている | 設定された表示名 | | 単一の加盟店アカウントで、表示名が設定されて**いない** | 注文情報の行には**加盟店名が一切表示されません** | | 親の下のサブ加盟店で、サブ加盟店名が設定されている | サブ加盟店の名前 | | 親の下のサブ加盟店で、サブ加盟店名が設定されて**いない** | 親の名前にフォールバックします | 重要な非対称性：未設定の表示名は、メインの注文情報の行では法人名にフォールバックしません—— 単に何も表示されません。ユーザーからチェックアウトで加盟店名が空白または予期しないものだと報告 された場合、この解決順序が最初に確認すべきことです。チェックアウト画面の他の部分には独自の フォールバックがあるため、名前がある場所では表示されず、別の場所では表示されることがあります。 ページに他に何が表示されるかは[チェックアウト表示ルール](/docs/ja/support/cashier-display-rules-faq)を 参照してください。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.