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[city] string

(任意だが推奨) 請求先住所の都市名。 カード保有者の請求先住所を指定し、米国、英国、カナダのカード保有者の承認率を向上させます。

card[country] string

(任意だが推奨) [ISO 3166コード]で指定される2文字の請求先住所の国名(http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)。 注:トークンの作成時に提供されずに、発行者識別番号(IIN)から生成された値の場合は正確ではない可能性があります。カード保有者の請求先住所を指定すると、米国、英国、カナダのカード保有者の承認率が向上します。

card[postal_code] string

(任意だが推奨) クレジットカード請求先の郵便番号。 カード保有者の請求先住所を指定すると、米国、英国、カナダのカード保有者の承認率が向上します。

card[security_code] string

(任意だが推奨) カードセキュリティコード(CVV、CVCなど)。裏面に記載されている。

card[state] string

(任意だが推奨) 請求先住所の州名。 カード保有者の請求先住所を指定し、米国、英国、カナダのカード保有者の承認率を向上させます。

card[street1] string

(任意だが推奨) 請求先住所の番地。 カード保有者の請求先住所を指定し、米国、英国、カナダのカード保有者の承認率を向上させます。

card[phone_number] string

(任意) 電話番号

card[street2] string

(任意) 請求先住所 #2

Example

  • 新しいトークンの作成

トークン情報の取得

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

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

Example

  • トークン情報の取得