Skip to main content

概要

トークンを使用すると、自社の決済フォームでカード情報を安全に収集できます。カードデータは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 に渡します:
完全な統合ガイドはサーバー間決済 (S2S)をご覧ください。
決済リクエストに save_card: truecustomer_id を追加することで、継続決済用にカードを保存できます。詳細はS2S決済 — カード保存をご覧ください。

JavaScript SDK

JavaScript SDKはオプションの便利なラッパーで、クライアントサイドのカードバリデーションとシンプルなAPIを提供します。
SDKはトークンIDを token として返します(APIレスポンスのフィールド名は id ですが、SDKが便宜上リネームしています)。