トークン作成時のテナントIDについて

PAY.JP PlatformのMarketplace型では、トークン作成時にテナントIDを指定することができます。
テナントIDを指定することで、チェックアウトやモバイルSDKで顧客のカード情報をトークン化する際、そのテナントの審査通過済ブランドのみ利用可能にすることができます。

注意事項

テナントIDはトークン作成の際に都度指定いただくことを強く推奨いたします。

テナントID未指定の場合、トークン作成時にカードの有効性確認を行いません。
そのため、実際に決済を確定するまでカードの利用可否がわからないため、間違ったカード情報でもカード登録が完了してしまうことにご注意ください。
テナントIDを指定することにより、上記を回避することができます。

※テナントIDはテナント作成時に指定可能な任意の値です(未指定時はten_で始まる値が発行されます)。

payjp.js v2

payjp.js v2 の options に {tenant: 'tenant_id'} を指定します。

チェックアウト

パラメーター data-tenant を指定します。

パラメーター

パラメータ名	説明	デフォルト
data-tenant	テナントID	なし

例

HTML内に下記のコードを埋め込むとフォームが生成されます:

<script
  type="text/javascript"
  src="https://checkout.pay.jp/"
  class="payjp-button"
  data-key="pk_test_0383a1b8f91e8a6e3ea0e2a9"
  data-tenant="ten_121673955bd7aa144de5a8f6c262"
  data-on-created="onCreated"
  data-text="支払う"
  data-submit-text="支払う"
  data-partial="true">
</script>

なおdata-tenantは公開鍵と同じくエンドユーザー側に公開される情報なため、当該パラメーターに入れる値にはご注意ください。

iOS SDK

カードフォームを利用の場合

CardFormViewController#createCardFormViewController の引数に tenantId を指定します。

let cardFormVc = CardFormViewController.createCardFormViewController(tenantId: "ten_121673955bd7aa144de5a8f6c262",
																	 delegate: self)
self.navigationController?.pushViewController(cardFormVc, animated: true)

CardFormTableStyledView を利用している場合は、各メソッドの引数に tenantId を指定します。

cardFormView.createToken(tenantId: "ten_121673955bd7aa144de5a8f6c262") { result in
    switch result {
    case .success(let token):
        print("[token] => \(token)")
    case .failure(let error):
        print("[failure creating token] \(error)")
    }

直接トークンを生成する場合

トークンを生成する際に tenantId パラメータを追加します。

payjpClient.createToken(
    with: number,
    cvc: cvc,
    expirationMonth: month,
    expirationYear: year,
    name: name,
    tenantId: "ten_121673955bd7aa144de5a8f6c262") { result in
    switch result {
    case .success(let token):
        print("[token] => \(token)")
    case .failure(let error):
        print("[failure creating token] \(error)")
    }
}

Android SDK

カードフォームを利用の場合

Payjp.cardForm().start() の引数に tenantId を指定します。

Payjp.cardForm().start(
    activity = this@SampleActivity,
    tenantId = TenantId("ten_121673955bd7aa144de5a8f6c262")
)

Fragmentを利用している場合は、 Payjp.cardForm().newCardFormFragment() の引数に tenantId を指定します。

Payjp.cardForm().newCardFormFragment(
    tenantId = TenantId("ten_121673955bd7aa144de5a8f6c262")
)

直接トークンを生成する場合

トークンを生成する際に tenantId パラメータを追加します。

Payjp.getInstance().createToken(
    number = number, 
    cvc = cvc, 
    expMonth = expMonth, 
    expYear = expYear, 
    name = name,
    tenantId = TenantId("ten_121673955bd7aa144de5a8f6c262")
)

Flutter プラグイン

Payjp.startCardForm() の引数に tenantId を指定します。

Payjp.startCardForm(tenantId: "ten_121673955bd7aa144de5a8f6c262");

React Native プラグイン

PayjpCardForm.startCardForm() の引数に tenantId を指定します。

PayjpCardForm.startCardForm({ tenantId : "ten_121673955bd7aa144de5a8f6c262" });