概要
トークンを使用すると、自社の決済フォームでカード情報を安全に収集できます。カードデータはJavaScript SDKと公開キーを使用してブラウザ上でトークン化されるため、生のカード番号がサーバーに送信されることはありません。トークン作成
POST /v1/tokens
認証: 公開キー(pk_test_* / pk_live_*)をBearerトークンとして使用
このエンドポイントは
fetch やその他のHTTPクライアントから直接呼び出せます。JavaScript SDK はオプションです。クライアントサイドのバリデーションやシンプルなAPIを提供しますが、必須ではありません。リクエストパラメータ
object
必須
カード情報オブジェクト
レスポンス
string
トークンID(
tok_ プレフィックス)。有効期限30分、1回のみ使用可能。object
マスクされたカード情報
string
作成日時(ISO 8601形式)
string
有効期限(ISO 8601形式)。作成から30分後。
トークンエラー
トークンを使った決済
トークン作成後、POST /v1/payments に渡します:
JavaScript SDK
JavaScript SDKはオプションの便利なラッパーで、クライアントサイドのカードバリデーションとシンプルなAPIを提供します。SDKはトークンIDを
token として返します(APIレスポンスのフィールド名は id ですが、SDKが便宜上リネームしています)。