Documentation Index
Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
POST /api/v1/tokenization/generate
リクエストパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|
tokenRequestId | String | はい | カードバインドリクエストの冪等性キー |
merchantUserId | String | はい | 加盟店側のユーザー ID |
tokenType | String | はい | トークン種別、"CARD" 固定 |
merchantInfo | Object | はい | 加盟店情報（merchantId を含む） |
notifyUrl | String | はい | カードバインド結果の Webhook コールバック URL |
tokenData | Object | いいえ | カードデータ（PCI-DSS 加盟店のみ） |
tokenData（PCI-DSS 加盟店のみ）
| パラメータ | 型 | 説明 |
|---|
pan | String | カード番号 |
name | String | カード名義 |
expiry | String | 有効期限（MM/YYYY） |
cvv | String | CVV |
レスポンスパラメータ
| パラメータ | 型 | 説明 |
|---|
tokenSessionId | String | セッション ID。フロントエンド SDK の tokenizationSubmit に渡します |
tokenId | String | トークン 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 を保存し、以降の決済に使用する必要があります。
