トークンの取得

GEThttps://vault.omise.co/tokens/:id

既存のトークンに関する情報（使用状況や関連するカードの詳細を含む）を取得します。

---

リクエストパラメータ

必須 - 1フィールド必須パラメータ

▼

`id`STRING(required)

取得するトークンID。tokn_で始まり、その後にtest_またはlive_と一意の識別子が続きます。

Example:"tokn_test_5xuy4w91xqz7d1w9u0t"

Constraints:有効なトークンIDである必要があります, パターン: tokn_(test|live)_[0-9a-z]+

---

レスポンス

200

取得成功

トークンが正常に取得されました。カードの詳細を含むトークンオブジェクトを返します。

レスポンスに含まれる内容:

• id - トークン識別子
• used - トークンが使用済みかどうか（未使用の場合はfalse、使用済みの場合はtrue）
• charge_status - トークンで作成された課金のステータス（未使用の場合はnull）
• card - サニタイズされた情報を含むカードオブジェクト
• card.brand - カードブランド（Visa、Mastercard、JCBなど）
• card.last_digits - カード番号の下4桁
• card.fingerprint - 一意のカード識別子
• card.security_code_check - CVVが検証されたかどうか
• created_at - トークン作成のタイムスタンプ（ISO 8601）

401

認証エラー

認証に失敗しました。APIキーが無効または欠落しています。

一般的な原因:

• Authorizationヘッダーの欠落
• 無効な公開鍵
• HTTP Basic Auth形式が正しくない

404

見つかりません

トークンが見つかりません。指定されたトークンIDは存在しません。

一般的な原因:

• 無効なトークンID形式
• トークンIDがアカウントに存在しない
• テストキーを使用してライブトークンにアクセス（またはその逆）
• トークンIDの入力ミス

5xx

サーバーエラー

サーバー側でエラーが発生しました。稀ですが、適切に処理する必要があります。

対処方法:

• 指数バックオフでリクエストを再試行する
• status.omise.coでサービスインシデントを確認する
• 詳細なガイダンスについてはエラー処理を参照

---

コードサンプル

cURL

curl https://vault.omise.co/tokens/tokn_test_5xuy4w91xqz7d1w9u0t \
  -u pkey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'pkey_test_5xuy4w91xqz7d1w9u0t'

token = Omise::Token.retrieve('tokn_test_5xuy4w91xqz7d1w9u0t')

Python

import omise

omise.api_public = 'pkey_test_5xuy4w91xqz7d1w9u0t'

token = omise.Token.retrieve('tokn_test_5xuy4w91xqz7d1w9u0t')

Node.js

const omise = require('omise')({
  publicKey: 'pkey_test_5xuy4w91xqz7d1w9u0t'
});

const token = await omise.tokens.retrieve('tokn_test_5xuy4w91xqz7d1w9u0t');

PHP

<?php
define('OMISE_PUBLIC_KEY', 'pkey_test_5xuy4w91xqz7d1w9u0t');

$token = OmiseToken::retrieve('tokn_test_5xuy4w91xqz7d1w9u0t');

Java

Client client = new Client.Builder()
    .publicKey("pkey_test_5xuy4w91xqz7d1w9u0t")
    .build();

Token token = client.tokens().get("tokn_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("pkey_test_5xuy4w91xqz7d1w9u0t");

var token = await client.Tokens.Get("tokn_test_5xuy4w91xqz7d1w9u0t");

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "",
)

token, _ := client.Tokens().Get("tokn_test_5xuy4w91xqz7d1w9u0t")

---

エラーコードと結果コード

一般的なエラーコード

コード	説明	解決方法
authentication_failure	無効なAPIキー	公開鍵が正しいことを確認
not_found	トークンが見つかりません	トークンIDが有効で存在することを確認

トークンステータス

フィールド	値	説明
used	false	トークンは未使用で利用可能
used	true	トークンは使用済みで再利用不可
charge_status	null	トークンはまだ使用されていません
charge_status	successful	トークンは成功した課金に使用されました
charge_status	failed	トークンは使用されましたが課金は失敗しました
charge_status	pending	トークンは使用され、課金は保留中です

---

🔑API認証情報

▼

試してみる

必須 - 1項目

▼

id(必須)

あなたのIP: ...読み込み中...