Skip to main content
Service → Payin は、お客様が実際に受け付ける契約を結んでいる内容——どの決済手段を、どの国と 通貨で、どの手数料基準で、どの金額上限と返金ルールのもとで——を記録した Portal のページです。 このページでは、その読み方と、決済がそれらの限度額のいずれかに達したときに何が起きるかを説明します。 注文作成そのものは Order Create フィールドガイドで、返金の挙動は 返金 FAQで、チェックアウト画面がユーザーに何を表示するかは チェックアウト表示ルールで説明しています。

契約している決済手段はどこで確認できますか?

Service → Payin です。契約済みの組み合わせごとに 1 行あり、列は次のとおりです: Fees と Settlement cycle はすべての契約タイプで表示されるわけではありません——お客様のページに なければ、それは契約の形態によるもので、権限が欠けているわけではありません。 バックエンドが提供しないものは空欄のままではなく - として表示されます。したがってダッシュは 「この行には何も設定されていない」という意味であり、「ゼロ」ではありません。

Fees 列はどう読めばよいですか?

Fees セルは単一の数値ではなく、複合的なものです。最大 4 つの部分から組み立てられます: 上限が固定金額ではなく比率で表現される場合、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 行目が追加されます: これは、ユーザーに返金総額を提示する際に重要です:支払者の手数料とお客様の手数料は別々のルールに 従います。返金時のお客様ご自身の手数料の挙動は 返金 FAQで説明しています。

T+3 のような精算サイクルはどういう意味ですか?

この表記はサイクルの文字、+、数で構成されます: つまり T+3 は遅延 3 の日次サイクル、W+1 は遅延 1 の週次サイクル、M+1 は月次サイクルです。 月次のバリエーションとして M+1X も表示されます。 日次の文字は D ではなく T であることに注意してください——自社システムにマッピングする場合、 D を前提にしないでください。サイクルが実際の支払いにどう変わるかは 精算サイクルで説明しています。

契約ステータスはそれぞれどういう意味ですか?

Status 列には 5 つの値のいずれかが色分けされて表示されます: 色を実務上のシグナルとして読んでください:緑は確定した稼働中の状態、黄はその行がまだ立ち上げ中で あること、赤は稼働していないことを意味します。Portal が認識しない値は隠されずにそのまま表示され、 空の値は - として表示されます。 取引を行う予定の行が緑でない場合は、連携のデバッグを始める前に Waffo の担当者に相談してください—— 契約状態は API からではなく Waffo 側で設定されます。

Refundable の値はそれぞれどういう意味ですか?

4 つの値があり、これらは形態に関するものであって、個々の注文を今すぐ返金できるかどうかに 関するものではありません: 隣の Refund Period は、決済後に返金がまだ受け付けられる期間です。両方が Portal の注文ごとの 返金操作に反映されます—— 返金ボタンが表示されない、またはグレーアウトしているのはなぜですか? を参照してください。

このページにはどのフィルターがありますか?エクスポートはできますか?

6 つのフィルターがあります:Payment Method Country、Payment method type、Payment method、 Order Currency、User Currency、Status。Product は列であってフィルターではありません—— 商品で絞り込むには、他のフィールドでフィルターをかけて Product 列を読んでください。 Export は現在のビューの CSV を生成します: Portal の他の場所にあるキュー処理される非同期エクスポートは挙動が異なります。 エクスポートとレポートのダウンロードを参照してください。

行の並び順が Payment Method Country 列と一致しないのはなぜですか?

行は国 → 決済手段タイプ → 決済手段名 → 商品の昇順で並べられます。 細かい点:並び替えのキーは契約自体の国フィールドですが、最初の列に表示されるのは決済手段の国です。 ほとんどの行では両者は一致しますが、異なる場合、見えている順序はお読みになっている列を基準にした 厳密なアルファベット順には見えません。並び替えは結果のページごとにも適用されるため、ページ送りで 全体が再ソートされることはありません。

Order Expiry Customization 列は実際に何を教えてくれるのですか?

その行で要求が許可されている注文有効期限の範囲です——単一のデフォルト値ではありません。 決済手段がカスタム有効期限を受け付ける場合、セルには時間の範囲が表示されます。受け付けない場合、 セルには - が表示され、有効期限は契約で定められたものになります。 読み方を決める 2 つの詳細:
  • 表示される範囲は、その行がモバイルアプリで許可するものとデスクトップブラウザで許可するものの 共通部分です。したがって、購入者がどの端末を使っていても安全な範囲です。行によっては、 ある端末に対して範囲が示すよりも寛容な場合があります。
  • お客様のページの少なくとも 1 行にカスタマイズ可能な有効期限がなければ、列全体が非表示に なります。列がないことは「お客様の行はいずれもこれをサポートしていない」という意味であり、 権限が欠けているわけではありません。

注文有効期限を自分で設定できますか?競合した場合はどちらが優先されますか?

order/create で orderExpiredAt を送信してください。省略すると契約の有効期限が適用されます—— これが文書化されたデフォルトです。 送信した値に何が起きるか: 読み違えないでほしいコードが 1 つあります:A0034 は、注文に対する処理が行われる時点で、 指定した有効期限がすでに期限切れになっている場合に返されます。「有効期限が許可範囲外だった」 ことを示すコードではありません。 注文有効期限は、設定されると購入者の決済可能時間になります——それが終了したときに何が起きるか、 どの注文状態が最終であるかは 決済タイムアウトと確定性にあります。

Mini Apps Info 列とは何ですか?

その行に登録されているウォレットのミニプログラムです。各エントリはミニアプリ名で、ホバーすると アプリの ID と名前が表示されます。この列はテーブルの右端に固定されており、お客様のページの 少なくとも 1 行にミニアプリのエントリがある場合にのみ表示されます——それ以外の場合は列自体が 存在せず、エントリのない行には - が表示されます。 ウォレットのミニプログラム内から決済を受け付ける場合にこれが必要になります。アプリ ID が、 決済手段に対してお客様のミニプログラムを識別するものだからです。商品(MINI_PROGRAM_PAYMENT)と 送信すべき端末値を含む連携そのものについては ミニプログラム決済にあります。

注文が限度額超過で拒否されました。どの限度額ですか?

限度額は 3 つあり、メッセージがどれかを教えてくれます: A0008 については、注文金額を該当する Service → Payin の行と比較してください。A0020 と A0021 については、行を見るのは適切ではありません:これらの限度額は加盟店 ID + 注文通貨のみをキーと しているため、支払者を同じ通貨の別の決済手段に切り替えても解決せず、ある通貨の限度額を引き上げても 別の通貨には何の効果もありません。A0021 では注文サイズではなく、その日が問題です。3 つとも注文 作成時に返されるため、注文が作成途中の状態で残ることはありません。 その注文通貨にアカウントレベルの限度額が設定されていない場合、A0020 / A0021 のチェックは 実行されず、どちらのエラーも発生しません。アカウントレベルの限度額は Service → Payin には 表示されません。知る必要がある場合は Waffo の担当者にお尋ねください。

日次限度額は正確にどのようにカウントされ、いつ枠が解放されますか?

実務上の影響は 2 点です:
  • 00:00 UTC+8 の直前に作成され、その後に成功した注文は、作成された日に対してカウントされます。
  • 放棄されたチェックアウトは、クローズするまで枠を消費します。上限付近で大量の注文をまとめて 処理している場合、差分を食いつぶしているのは通常これであり、成功した決済ではありません。

自分が何もしなくても限度額が変わることはありますか?

はい。決済手段の基盤となるプロバイダーが限度額を改定した場合、Waffo はお客様の契約の限度額を 再計算し、新しい範囲が Service → Payin に表示されます。知っておくべき仕組みが 2 つあります:
  • プロバイダーの限度額がお客様の契約と異なる通貨で表現されている場合、適用前に換算されるため、 結果の数値が丸い数になることはほとんどありません。
  • 端数処理は意図的に保守的です:最小値は切り上げ、最大値は切り下げられるため、結果の範囲が 元の範囲より広くなることはありません。補助単位のない通貨——JPY、KRW、VND など——では、 最小値は整数単位になります。
新しい範囲外のリクエストは、変更が反映された時点から上記の 2 つのエラーで拒否されます。注文量が 限度額に近い場合は、連携内で値をキャッシュするのではなく、Service → Payin から値を読み取ってください。

使用している決済手段が廃止されます。どのように通知されますか?

お客様の契約が終了すると、その決済手段を明記したメールが、加盟店アカウントの管理者および スーパー管理者ユーザーに送信されます。詳細: その後、Service → Payin でその行は赤で Terminated と表示され、その組み合わせでの新規注文は 拒否されます。既存の注文とその返金は、ステータス変更そのものによる影響を受けません。その決済手段が チェックアウトにとって重要な場合は、Waffo の担当者に代替を依頼してください——Portal には終了した 行を再度有効にするセルフサービスの手段はありません。

チェックアウトでユーザーに表示される加盟店名はどれですか?

チェックアウト画面には表示名が表示され、次の順序で解決されます: 重要な非対称性:未設定の表示名は、メインの注文情報の行では法人名にフォールバックしません—— 単に何も表示されません。ユーザーからチェックアウトで加盟店名が空白または予期しないものだと報告 された場合、この解決順序が最初に確認すべきことです。チェックアウト画面の他の部分には独自の フォールバックがあるため、名前がある場所では表示されず、別の場所では表示されることがあります。 ページに他に何が表示されるかはチェックアウト表示ルールを 参照してください。