プラットフォーム概要

Jammのプラットフォーム連携入門 — 資金の流れ、入金モード、開発前に押さえておくべき基本概念を説明します。

プラットフォームとしての認証情報を使用し、プラットフォームに連携された加盟店の代理として操作を行います。プラットフォーム連携により、以下のことが可能になります：

• 加盟店に代わって決済を作成する
• 顧客の登録・管理を行う
• 返金を処理する
• 各取引にプラットフォーム手数料を設定する
• 入金を受け取る（入金モードに応じて、一括または収益分のみ）

資金の流れ

資金の流れは、プラットフォームの入金モードによって異なります。モードはプラットフォームアカウント作成時に設定され、2種類あります。

一括入金モード（PLATFORM）— Jammがプラットフォームに支払い、プラットフォームが加盟店へ分配

• 顧客が支払う → amount（JPY）
• Jammが控除 → jamm_fee
• プラットフォームが受け取る → amount - jamm_fee（一括）

注: 加盟店への分配はプラットフォームが自ら行います。このモードでは、Jammは加盟店との資金分配を追跡・強制しません。各入金には、資金分配の参考として加盟店別の内訳レポートが添付されます。

ダイレクトモード（MERCHANT）— Jammが各加盟店へ直接支払い、プラットフォームは収益分を別途受け取り

• 顧客が支払う → amount（JPY）
• Jammが控除 → jamm_fee
• 加盟店が受け取る → amount - platform_fee（Jammが支払い）
• プラットフォームが受け取る → platform_fee - jamm_fee（Jammが別途支払い）

注: platform_feeが設定されていない場合、プラットフォームの取り分はなく、加盟店はJamm手数料のみを負担します。

はじめに

連携を開始するには、以下が必要です：

• Jammによってプロビジョニングされたプラットフォームアカウント（plt-*形式のプラットフォームIDが発行されます）
• プラットフォームに連携された1つ以上の加盟店
• API認証情報

完全なセットアップ手順については、Onboarding Guideをご参照ください。連携にはJamm SDKまたはREST APIを直接使用できます。

基本概念

認証

プラットフォームの認証情報（クライアントIDとクライアントシークレット）を使用して認証します。特定の加盟店の代理として操作を行うには、SDKのmerchantオプションを使用して、各リクエストに加盟店のIDを指定してください。加盟店ごとに個別の認証情報は必要ありません — 1つのプラットフォームトークンで、プラットフォームに連携されたすべての加盟店へのアクセスが可能です。

加盟店のオンボーディング

加盟店の代理として操作を行うには、事前に加盟店をプラットフォームに連携する必要があります。プラットフォームの設定によって、加盟店は即時に有効化される場合と、有効化前にJammチームによる審査・承認が必要な場合があります。この設定は、プラットフォームアカウント作成時にJammが行います。

セットアップ手順については、オンボーディングガイドを参照してください。

入金モード

プラットフォームは、2つの入金モードのいずれかで設定されます。これはプラットフォームレベルで設定され、すべての取引に自動的に適用されます。

• 一括入金（PLATFORM） — Jammがすべての加盟店取引をまとめた一括金額をプラットフォームに支払います。プラットフォームは内訳レポートを使用して加盟店へ分配します。
• ダイレクト（MERCHANT） — Jammが各加盟店へ直接支払います。プラットフォームは収益分を別途入金として受け取ります。

注: 入金モードはリクエストごとに選択するものではありません。プラットフォームアカウント作成時に設定されます。詳細な計算方法と例については、入金ガイドをご参照ください。

プラットフォーム手数料（platform_fee）— ダイレクトモード専用

platform_feeはダイレクトモード（MERCHANT）に適用されます。これは取引ごとに加盟店から控除される合計手数料であり、Jammの処理手数料とプラットフォームの利益分の両方が含まれます。取引ごとの実際の収益はplatform_fee - jamm_feeとなります。

例: jamm_feeが300円でplatform_feeを500円に設定した場合、加盟店は合計500円を負担します。Jammが300円を受け取り、プラットフォームが200円を受け取ります。

主なルール：

• 請求リクエストのplatform_feeフィールドで取引ごとに設定
• >= jamm_feeである必要があります（Jamm手数料を下回る値はJammに拒否されます）
• 未指定の場合、加盟店はJamm手数料のみを負担し、プラットフォームはその取引で何も受け取りません
• 一括入金モードの場合: platform_feeを指定することはできますが、メタデータとしてのみ扱われます。一括入金の計算には影響しません。プラットフォーム独自の記録管理のため、加盟店別内訳レポートに表示されます。