PAY.JP Platform テナントの作成・管理(Marketplace)

Marketplace 型のテナントは、テナントの作成・クレジットカード審査依頼・継続管理までAPIを利用して実装することができます。

ここではテナントの作成〜クレジットカード審査依頼の方法からテナント管理のプロセスについて説明します。

前提

ここで登録されたテナントは、基本的に PAY.JPを認識しない想定 となります。 テナントを作成・管理するのはあくまでプラットフォーマーであり、テナント側がPAY.JPを認識し、PAY.JP上で自ら売上・返金などの操作をすることは想定されていません。

またテナントはPAY.JPのダッシュボードにログインすることはできません。

一方でプラットフォーマーは、あらゆるPAY.JP APIに付随する操作に加え、テナントの銀行口座および最低入金額などを管理・変更することが可能です。

テナントの新規作成

Platform APIを使ってまずはテナントの作成を行いましょう。

テナントの新規作成

$ curl https://api.pay.jp/v1/tenants \
-u sk_live_xxx: \
-d id=test \
-d name=test \
-d platform_fee_rate=10.15 \
-d minimum_transfer_amount=1000 \
-d bank_account_holder_name=ヤマダ タロウ  \
-d bank_code=0001  \
-d bank_branch_code=001  \
-d bank_account_type=普通  \
-d bank_account_number=0001000  \

テナントの表示名称である name ほか必須のパラメータをセットしてテナントの新規作成を行います。

また通常は、プラットフォーム利用者の店子(以下テナントと表す)の情報を元に新規にテナントを作成いたしますのでプラットフォーマ側で専用の入力フォームなどを用意していただく必要があります。

本番利用申請

テナントが本番環境を利用するにはプラットフォーマー自身の本番利用申請が必要になります。

本番利用申請はPlatform用の専用管理画面から行うことができます。

テナントの基本情報の申請 (Visa/MasterCard/JCB/American Express/Diners Club/Discoverの審査)

Marketplace 型のテナントに関しましては、Visa/MasterCard/JCB/American Express/Diners Club/Discoverなどのカードブランド別の本番利用申請が必要となります。 この申請はテナント自身で行うことになりますが、申請用のフォームに関してはプラットフォーマー側でPAY.JPのAPIを利用して払い出す必要があります。

流れとしては、プラットフォーマー側でPAY.JP API経由でワンタイムの審査申請ページURLを取得して、テナントに対してその取得した審査申請ページを表示します。 テナントはこの申請画面に、プラットフォームを利用するにあたっての基本情報を入力します。 取得した審査申請ページURLの末尾には return_to というクエリーパラメーターを付与し、申請情報のsubmit後にリダイレクト遷移する先を指定してください。

テナントの審査申請ページのURLを作成

curl https://api.pay.jp/v1/tenants/ten_121673955bd7aa144de5a8f6c262/application_urls \
-u sk_live_xxx: \
-XPOST

取得した審査申請ページのURLにリダイレクトURLを付与

https://pay.jp/_/applications/start/32e1ed9eb0484c0fab997fd844475d60?return_to=https://pay.jp

より詳しくはAPIリファレンスの テナントの審査申請ページのURLを作成 をご参照ください。

この申請がテナントから行われますと、自動的にPAY.JP / クレジットカード会社側でVisa/MasterCard/JCB/American Express/Diners Club/Discoverの審査を実施いたします。

なおテナントがクレジットカード審査を通過するまで下記の制限がかかりますのでご注意ください

  • 当該テナントの売上処理に関して、テナントへの入金が行われず、繰越状態となる
  • 当該テナントの売上処理に紐付いた platform_fee については、通常通りプラットフォーマーへ入金が行われる

また、審査の際に確認が必要な情報に関して、PAY.JPからプラットフォーマーのメールアドレス宛にテナント情報の修正依頼または確認の連絡をする場合があります。

この修正が必要な場合は、下記のステップで修正を行ってください。

  1. 修正にはプラットフォーマーがテナントの審査申請ページを払い出すAPIを利用して申請ページを取得し、その払い出されたURLに対してテナント自身で対象項目の修正を行う
  2. テナント側での修正が完了しましたら、プラットフォーマーからPAY.JP 宛に修正の連絡を行う

Visa/MasterCardの審査結果は最短2営業日でご連絡いたします。

JCB/American Express/Diners Club/Discoverは、審査結果まで15営業日ほどのお時間をいただいております。

テナント登録時の利用規約について

PAY.JP Platform の利用規約には下記の2種類が存在しています。

  1. プラットフォーマー向け利用規約(Marketplace型)
  2. プラットフォーム加盟店向け利用規約(Marketplace型)

1の「プラットフォーマー向け利用規約」はプラットフォーマーに対して PAY.JP Platform 新規登録時に適用される利用規約です。

対して2の「プラットフォーム加盟店向け利用規約(Marketplace型)」はプラットフォーマーに紐づくテナントに適用されることを想定した利用規約です。

プラットフォーム加盟店向け利用規約については、テナントからPAY.JPへの本番申請時にPAY.JPの本番申請ページから同意いただく導線となっております。

テナントの管理

テナントの情報更新、削除といった操作をAPIで行うことができます。

テナントの情報更新

テナントから取得する料率(platform_fee_rate)や最低入金額(minimum_transfer_amount)、銀行情報を更新することができます

curl https://api.pay.jp/v1/tenants/ten_121673955bd7aa144de5a8f6c262 \
-u sk_live_xxx: \
-d platform_fee_rate=30

テナントの削除

既存のテナント情報を削除します

curl https://api.pay.jp/v1/tenants/ten_121673955bd7aa144de5a8f6c262 \
-u sk_live_xxx: \
-XDELETE

テナントが本番環境の決済を利用している場合、クレジットカード決済の当該利用契約を停止します。

削除時に未振込の売上金額が振込手数料である250円以上残っている場合には、次回確定分入金時に基本情報として登録済みの銀行口座へ入金します。

テナントAPIのテスト

テナントAPIは基本的にプラットフォーマーのAPIキーを使ってテストが可能です。

以上でテナントの登録・管理のプロセスを説明しました。最後に実際の決済処理と入金の振り分けの実装と仕組みを確認しましょう。