メインコンテンツへスキップ
POST /api/v1/tokenization/generate

​
リクエストパラメータ

パラメータ型必須説明
tokenRequestIdStringはいカードバインドリクエストの冪等性キー
merchantUserIdStringはい加盟店側のユーザー ID
tokenTypeStringはいトークン種別、"CARD" 固定
merchantInfoObjectはい加盟店情報（merchantId を含む）
notifyUrlStringはいカードバインド結果の Webhook コールバック URL
tokenDataObjectいいえカードデータ（PCI-DSS 加盟店のみ）

​
tokenData（PCI-DSS 加盟店のみ）

パラメータ型説明
panStringカード番号
nameStringカード名義
expiryString有効期限（MM/YYYY）
cvvStringCVV

​
レスポンスパラメータ

パラメータ型説明
tokenSessionIdStringセッション ID。フロントエンド SDK の tokenizationSubmit に渡します
tokenIdStringトークン ID（PCI-DSS 加盟店が直接送信した場合のみ返却）

​
リクエスト例

​
標準フロー（フロントエンド SDK 経由で送信）

{
  "tokenRequestId": "treq_a1b2c3d4e5f6",
  "merchantUserId": "user_123",
  "tokenType": "CARD",
  "merchantInfo": { "merchantId": "M000001" },
  "notifyUrl": "https://your-site.com/webhook/tokenization"
}

​
レスポンス例

{
  "code": "0",
  "msg": "Success",
  "data": {
    "tokenSessionId": "tsess_xxxxxxxxxxxx"
  }
}
tokenSessionId を取得した後、フロントエンド SDK の tokenizationSubmit メソッドに渡してカード送信を完了します。

​
カードバインド結果通知

カードバインド完了後、Waffo は notifyUrl に Webhook 通知を送信し、tokenId を含みます。加盟店はこの tokenId を保存し、以降の決済に使用する必要があります。