Token(トークン)

Tokens(トークン)は、クレジットカードの情報をあなたが保持・管理することなくクレジットカード決済・課金を行うために使用します。 クレジットカードの情報は、TokenオブジェクトとしてOmiseのサーバーで管理されます。 新しい課金を行う際には、Omise-JSでユーザーが入力したクレジットカード情報を事前にOmiseへ送信し、Omiseが発行したTokenのIDを利用して、サーバーサイドでCharge APIを使います。また、トークンは一度だけCharge APIで使用できます。使用済みの同じトークンIDを使った課金はできません。

クレジットカード情報は、Omise以外のサーバーサイドへ送信しないでください。 Omiseの利用方法を守り、ブラウザでユーザーが入力したクレジットカード情報は、omise.jsまたはcard.jsを利用し、Omiseへ送信し、レスポンスで返されるトークンIDをあなたのサーバーサイドで利用し、課金を行ってください。クレジットカード情報など、セキュリティに関する内容は、セキュリティ対策をご覧ください。は、セキュリティ対策をご覧ください。

Attributes

Name Type Description
object string

固定値token

id object_id

/tokn(_test)?_[0-9a-z]+/に一致するTOKEN_ID

livemode boolean

本番モード (true) あるいはテストモード(false) トークン。

location string

現在のtokenオブジェクトを取得するためのAPIパス。

card card

トークンを生成するため使用されたカードに関する詳細を含むカードオブジェクト。

created_at datetime

ISO 8601 形式 (YYYY-MM-DDThh:mm:ssZ)でトークンが作成されたUTC日時。

used boolean

トークンが使用されたかどうか。トークンは課金、または「顧客」(/customers-api)の新しいカードとして関連付けるために1回だけ使用できます。

Example

  • JSON Response

新しいトークンの作成

- POST https://vault.omise.co/tokens

クレジットカード詳細の代替IDとなる、一度だけ使用可能な使い切りトークンを作成します。

Request Parameters

Name Type Description
card[expiration_month] integer

(必須) カードの有効期限に記載されている '月' (1-12)。

card[expiration_year] integer

(必須) カードの有効期限に記載されている '年' 。

card[name] string

(必須) クレジットカード表面に記載されている所有者の名義。

card[number] string

(必須) Card number.

card[city] string

(任意) クレジットカードで登録している住所の「市」 。

card[country] string

(任意) 2文字の国コードISO 3166 。注:発行者識別番号(IIN)から取得するので正確ではない場合があります。

card[phone_number] string

(任意) 請求先住所の電話番号

card[postal_code] string

(任意) Omiseで登録している住所の '郵便番号' 。

card[security_code] string

(任意) Card security code (CVV, CVC, etc). Printed on the back.

card[state] string

(任意) 請求先住所の状況

card[street1] string

(任意) 請求先住所 #1

card[street2] string

(任意) 請求先住所 #2

Example

  • 新しいトークンの作成

  • 新しいトークンの作成

トークン情報の取得

- GET https://vault.omise.co/tokens/{id}

トークンIDで指定したトークンの情報を返します。

Example

  • トークン情報の取得