ดึงข้อมูล Token

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

ดึงข้อมูลเกี่ยวกับ Token ที่มีอยู่รวมถึงสถานะการใช้งานและรายละเอียดบัตรที่เกี่ยวข้อง

---

พารามิเตอร์คำขอ

จำเป็น - 1 ฟิลด์พารามิเตอร์ที่จำเป็น

▼

`id`STRING(required)

Token ID ที่ต้องการดึงข้อมูล ต้องเริ่มต้นด้วย tokn_ ตามด้วย test_ หรือ live_ และตัวระบุเฉพาะ

Example:"tokn_test_5xuy4w91xqz7d1w9u0t"

Constraints:ต้องเป็น Token ID ที่ถูกต้อง, รูปแบบ: tokn_(test|live)_[0-9a-z]+

---

การตอบกลับ

200

ดึงข้อมูลสำเร็จ

ดึงข้อมูล Token สำเร็จ ส่งคืนออบเจกต์ Token พร้อมรายละเอียดบัตร

การตอบกลับประกอบด้วย:

• id - ตัวระบุ Token
• used - Token ถูกใช้งานแล้วหรือไม่ (false หากยังไม่ได้ใช้ true หากใช้แล้ว)
• charge_status - สถานะของการเรียกเก็บเงินที่สร้างด้วย Token (null หากยังไม่ได้ใช้)
• card - ออบเจกต์บัตรพร้อมข้อมูลที่ปกป้องแล้ว
• card.brand - แบรนด์บัตร (Visa, Mastercard, JCB ฯลฯ)
• card.last_digits - 4 หลักสุดท้ายของหมายเลขบัตร
• card.fingerprint - ตัวระบุเฉพาะของบัตร
• card.security_code_check - CVV ได้รับการตรวจสอบแล้วหรือไม่
• created_at - เวลาที่สร้าง Token (ISO 8601)

401

ไม่ได้รับอนุญาต

การยืนยันตัวตนล้มเหลว API Key ไม่ถูกต้องหรือไม่มี

สาเหตุที่พบบ่อย:

• ไม่มี Authorization header
• Public Key ไม่ถูกต้อง
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

ไม่พบ

ไม่พบ Token Token ID ที่ระบุไม่มีอยู่

สาเหตุที่พบบ่อย:

• รูปแบบ Token ID ไม่ถูกต้อง
• Token ID ไม่มีอยู่ในบัญชีของคุณ
• ใช้ Key ทดสอบเพื่อเข้าถึง Token จริง (หรือในทางกลับกัน)
• พิมพ์ Token ID ผิด

5xx

ข้อผิดพลาดเซิร์ฟเวอร์

เกิดข้อผิดพลาดฝั่งเซิร์ฟเวอร์ เกิดขึ้นได้ยากแต่ควรจัดการอย่างเหมาะสม

วิธีจัดการ:

• ลองคำขอใหม่ด้วย exponential backoff
• ตรวจสอบ 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 Key ไม่ถูกต้อง	ตรวจสอบว่า Public Key ของคุณถูกต้อง
not_found	ไม่พบ Token	ตรวจสอบว่า Token ID ถูกต้องและมีอยู่

สถานะ Token

ฟิลด์	ค่า	คำอธิบาย
used	false	Token ยังไม่ได้ใช้และพร้อมใช้งาน
used	true	Token ถูกใช้งานแล้วและไม่สามารถใช้ซ้ำได้
charge_status	null	Token ยังไม่ได้ใช้
charge_status	successful	Token ถูกใช้สำหรับการเรียกเก็บเงินที่สำเร็จ
charge_status	failed	Token ถูกใช้แต่การเรียกเก็บเงินล้มเหลว
charge_status	pending	Token ถูกใช้ การเรียกเก็บเงินรอดำเนินการ

---

🔑ข้อมูลยืนยันตัวตน API

▼

ลองใช้งาน

จำเป็น - 1 ฟิลด์

▼

id(จำเป็น)

IP ของคุณ: ...กำลังโหลด...