プラットフォーム入金ガイド
Jammがプラットフォームへの入金をどのように計算・スケジュールするかを説明します。一括入金とダイレクトモードの計算方法、手数料、返金、および計算例を含みます。
概要
Jammは定期的なスケジュールでプラットフォームへの入金を処理します。入金の仕組みは、アカウント作成時にプラットフォームレベルで設定される入金モードによって異なります。
| モード | API値 | プラットフォームが受け取るもの | 加盟店への入金 |
|---|---|---|---|
| 一括入金 | PLATFORM | すべての加盟店取引を含む一括入金 | なし — プラットフォームが加盟店へ分配 |
| ダイレクト | MERCHANT | 収益分のみ | Jammが加盟店へ直接支払い |
入金スケジュール
2種類のスケジュールが利用可能です：
| スケジュール | 期間 | 入金処理手数料（jamm_taxable_fee） |
|---|---|---|
月次（EVERY_MONTH） | 1日〜月末 | 0円 |
月2回（TWICE_PER_MONTH） | 1日〜15日、16日〜月末 | 1日〜15日の期間：0円、16日〜月末の期間：2,000円 |
- すべての入金期間はJST（日本標準時、UTC+9）を使用します。取引の入金期間は、JSTでの発生日時によって決定されます。
- 入金は毎月15日、または該当する場合は次の営業日に行われます。
用語説明
入金レポートでは特定のフィールド名が使用されます。APIで送受信する値との対応は以下のとおりです：
| 入金レポートの用語 | 参照元 | 説明 |
|---|---|---|
initial_amount | 請求リクエストでpriceとして送信。レスポンスおよび入金レポートではinitial_amountとして表示されます。 | 元の請求金額（JPY） |
refund_amount | 返金のamount（全額返金の場合はinitial_amountの全額） | 承認された返金額（JPY） |
jamm_fee | 請求レスポンスで返されます。プラットフォームが設定するものではありません。 | Jammの処理手数料。すべての取引から控除されます。 |
platform_fee | 請求リクエストのplatform_fee | 加盟店から控除される合計手数料（Jammの手数料とプラットフォームの利益分を含む）。概要のプラットフォーム手数料を参照してください。 |
platform_feeに関する注意: 取引にplatform_feeが設定されていない場合、Jammは入金計算においてjamm_feeと同額として扱います。これはプラットフォームがその取引で利益を得ないことを意味し、加盟店はJamm手数料のみを負担します。
一括入金モード（PLATFORM）
一括入金モードでは、Jammはプラットフォームに一括で入金を行います。各加盟店への資金分配はプラットフォームが責任を持って行います。
計算方法
合計請求額 = すべての加盟店の initial_amount の合計 合計Jamm手数料 = すべての加盟店の jamm_fee の合計 合計返金額 = すべての承認済み返金額の合計 入金処理手数料 = スケジュール基本料 +（返金件数 × 200円） 消費税 = 入金処理手数料 × 10% 合計入金額 = 合計請求額
- 合計Jamm手数料
- 合計返金額
- 入金処理手数料
- 消費税
計算例
プラットフォームXには加盟店AとBがあります。ある入金期間において：
| 取引 | 加盟店 | 請求額（initial_amount） | Jamm手数料 | プラットフォーム手数料 |
|---|---|---|---|---|
trx-1 | A | 10,000 | 300 | 500 |
trx-2 | A | 5,000 | 150 | 未設定 |
trx-3 | B | 8,000 | 240 | 400 |
返金1件: trx-2が全額返金（5,000円）。
内訳：
合計請求額 = 10,000 + 5,000 + 8,000 = 23,000 合計Jamm手数料 = 300 + 150 + 240 = 690 合計返金額 = 5,000 入金処理手数料 = 0 +（1 × 200） = 200 消費税 = 200 × 10% = 20 合計入金額 = 23,000 - 690 - 5,000 - 200 - 20 = 17,090
Jammはプラットフォームに17,090円を振り込みます。
加盟店別内訳
各入金と合わせて、資金分配の参考となる加盟店別の内訳レポートが提供されます。merchant_net_amountは、各取引のinitial_amount - jamm_feeの合計から、その加盟店の返金額を差し引いて計算されます。
| 加盟店 | 請求合計 | Jamm手数料 | 返金 | 加盟店純受取額 |
|---|---|---|---|---|
| A | 15,000 | 450 | 5,000 | 15,000 - 450 - 5,000 = 9,550 |
| B | 8,000 | 240 | 0 | 8,000 - 240 = 7,760 |
ダイレクトモード（MERCHANT）
ダイレクトモードでは、Jammが標準の加盟店入金プロセスを通じて各加盟店へ直接支払いを行います。プラットフォームは収益分のみを別途入金として受け取ります。
加盟店への入金（Jammが処理）
加盟店はplatform_feeが控除された上でJammから直接入金を受け取ります：
加盟店入金額 = 各取引の（initial_amount - platform_fee）の合計
- 返金額
- 加盟店自身の入金処理手数料
- その手数料に対する消費税
取引にplatform_feeが設定されていない場合、Jamm手数料相当額が加盟店から控除され、プラットフォームは何も受け取りません。
プラットフォームの収益入金
プラットフォームの利益分は別途入金として受け取ります： 合計プラットフォーム手数料 = 各取引の platform_fee（未設定の場合は jamm_fee）の合計 合計Jamm手数料 = 各取引の jamm_fee の合計 プラットフォーム収益 = 合計プラットフォーム手数料 - 合計Jamm手数料 入金処理手数料 = スケジュール基本料のみ ※ ダイレクトモードでは、返金1件あたり200円の手数料は加盟店に請求され、プラットフォームには請求されません。 消費税 = 入金処理手数料 × 10% 合計入金額 = プラットフォーム収益 - 入金処理手数料 - 消費税
計算例
一括入金の例と同じ取引をダイレクトモードで処理した場合：
加盟店Aへの入金（Jammから直接）：
取引合計：（10,000 - 500）+（5,000 - 150）= 14,350 返金：5,000 純額：14,350 - 5,000 = 9,350（加盟店自身の入金処理手数料および消費税を除く）
加盟店Bへの入金（Jammから直接）：
取引合計：（8,000 - 400）= 7,600 返金：0 純額：7,600（加盟店自身の入金処理手数料および消費税を除く）
プラットフォームXへの入金（収益分のみ）：
プラットフォーム収益 = (500 - 300) + (150 - 150) + (400 - 240) = 360 処理手数料 = 0（この期間の基本料なし） 合計入金額 = 360円
キャンセルと返金の違い
手数料に影響するキャンセルと返金の重要な違いがあります。
キャンセル
キャンセルは、請求が作成された同じ日（JST深夜0時前）に取り消された場合に発生します。キャンセルは無料です：
- 200円の返金手数料は発生しません。
platform_feeは請求されません — 取引は最初から存在しなかったものとして扱われます。- 取引は入金から完全に除外されます。
返金
返金は、請求が作成された翌日以降（JST深夜0時以降）に取り消された場合に発生します。返金にはコストが伴います：
- 200円の返金手数料が発生します。
- プラットフォームは収益を保持します（
platform_fee - jamm_fee）— 返金時に取り消されません。 - 返金額は次回の入金から差し引かれます。
部分返金
返金リクエストで元のinitial_amountより少ないamountを指定することで、部分返金を行うことができます。指定した金額のみが入金から差し引かれます。200円の返金手数料は、返金額にかかわらず返金1件につき発生します。
返金の入金への影響
一括入金モード（PLATFORM）
- 返金額はプラットフォームの入金から差し引かれます。
- 返金1件につき200円の返金手数料がプラットフォームの入金処理手数料に加算されます。
- 加盟店別内訳には返金の明細が表示されるため、加盟店への分配時に照合できます。
- 加盟店から返金額を回収するか、将来の分配額と相殺するかはプラットフォームの責任で行います。
ダイレクトモード（MERCHANT）
- 返金額は加盟店の次回入金から差し引かれます。
- 200円の返金手数料は加盟店に請求されます。
- プラットフォームは収益分を保持します — 返金時に取り消されません。
手数料まとめ
| 手数料 | 説明 |
|---|---|
| Jamm手数料 | Jammの取引ごとの処理手数料。すべての取引から控除されます。 |
| プラットフォーム手数料 | 取引ごとに加盟店から控除される合計手数料（Jamm手数料 + プラットフォームの利益分）。各請求ごとにプラットフォームが設定します。一括入金モードでは参考情報としてのみ扱われます。 |
| 入金処理手数料 | 期間ごとの手数料。スケジュール基本料 + 返金1件につき200円（一括入金モードのみ — ダイレクトモードでは返金手数料は加盟店に請求されます）。 |
| 消費税 | 入金処理手数料の10%（日本の消費税）。 |
privacy policy and terms and conditions.