Token(トークン)

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

Attributes

Name Type Description
object string

固定値token

id string

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

livemode boolean

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

location string

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

card card

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

charge_status string

Status of charge created using this token (if any). Value is one of allowed charge.status values or, no charge has been created, unknown.

created_at string

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

(任意) 電話番号

card[postal_code] string

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

card[security_code] string

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

card[state] string

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

card[street1] string

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

card[street2] string

(任意) 請求先住所 #2

Example

  • 新しいトークンの作成

  • 新しいトークンの作成

トークン情報の取得

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

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

Example

  • トークン情報の取得

Omiseは、お客様のウェブサイト全般における利便性を向上するためにクッキーを利用し、お客様のアクセス、閲覧履歴に関する情報を収集します。 当社のウェブサイトを閲覧し続けることにより、お客様は当社のプライバシーポリシーに同意することとします。 詳細はこちら