สร้างโทเค็น

POSThttps://vault.omise.co/tokens

สร้างโทเค็นแบบใช้ครั้งเดียวจากข้อมูลบัตรเครดิต โทเค็นจะแสดงข้อมูลบัตรอย่างปลอดภัยและสามารถใช้สร้างการเรียกเก็บเงินได้โดยไม่ต้องจัดการข้อมูลบัตรที่ละเอียดอ่อนบนเซิร์ฟเวอร์ของคุณ

---

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

▼

---

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

จำเป็น - 4 รายการพารามิเตอร์ที่จำเป็น

▼

`card[name]`STRING(required)

ชื่อผู้ถือบัตรตามที่ปรากฏบนบัตร

Example:"JOHN DOE"

`card[number]`STRING(required)

หมายเลขบัตรโดยไม่มีช่องว่างหรือขีดกลาง มี 13-19 หลักขึ้นอยู่กับประเภทบัตร

Example:"4242424242424242"

Constraints:13-19 หลัก, ต้องผ่านการตรวจสอบ Luhn, ไม่มีช่องว่างหรือขีดกลาง

`card[expiration_month]`INTEGER(required)

เดือนหมดอายุของบัตรในรูปแบบ M หรือ MM

Example:12

Constraints:ค่าต่ำสุด: 1, ค่าสูงสุด: 12

`card[expiration_year]`INTEGER(required)

ปีหมดอายุของบัตรในรูปแบบ YY หรือ YYYY

Example:2025

Constraints:ต้องเป็นปีปัจจุบันหรืออนาคต, รับรูปแบบ 2 หลักหรือ 4 หลัก

แนะนำ - 7 รายการพารามิเตอร์แนะนำ

▼

เพิ่มเติม - 2 รายการพารามิเตอร์เพิ่มเติม

▼

---

การตอบกลับ

200

สำเร็จ

สร้างโทเค็นสำเร็จแล้ว สามารถใช้ Token ID เพื่อสร้างการเรียกเก็บเงินหรือเชื่อมโยงกับลูกค้าได้

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

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

400

คำขอไม่ถูกต้อง

การตรวจสอบคำขอล้มเหลว โปรดตรวจสอบข้อความแสดงข้อผิดพลาดสำหรับรายละเอียด

สาเหตุทั่วไป:

• ฟิลด์ที่จำเป็นหายไป (card[name], card[number], card[expiration_month], card[expiration_year])
• รูปแบบหมายเลขบัตรไม่ถูกต้อง
• วันหมดอายุไม่ถูกต้อง
• หมายเลขบัตรมีช่องว่างหรือขีดกลาง

401

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

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

สาเหตุทั่วไป:

• ขาดหัวข้อ Authorization
• คีย์สาธารณะไม่ถูกต้อง
• ใช้คีย์ลับแทนคีย์สาธารณะ
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

402

ต้องการการชำระเงิน

การตรวจสอบบัตรล้มเหลว

สาเหตุทั่วไป:

• หมายเลขบัตรไม่ผ่านการตรวจสอบ Luhn
• บัตรหมดอายุแล้ว
• รูปแบบรหัสความปลอดภัยไม่ถูกต้อง
• ยี่ห้อบัตรไม่รองรับ

---

ตัวอย่างโค้ด

cURL

curl https://vault.omise.co/tokens \
  -u pkey_test_5xuy4w91xqz7d1w9u0t: \
  -d "card[name]=JOHN DOE" \
  -d "card[number]=4242424242424242" \
  -d "card[expiration_month]=12" \
  -d "card[expiration_year]=2025" \
  -d "card[security_code]=123"

Ruby

require 'omise'

Omise.api_key = 'pkey_test_5xuy4w91xqz7d1w9u0t'

token = Omise::Token.create({
  card: {
    name: 'JOHN DOE',
    number: '4242424242424242',
    expiration_month: 12,
    expiration_year: 2025,
    security_code: '123'
  }
})

Python

import omise

omise.api_public = 'pkey_test_5xuy4w91xqz7d1w9u0t'

token = omise.Token.create(
    card={
        'name': 'JOHN DOE',
        'number': '4242424242424242',
        'expiration_month': 12,
        'expiration_year': 2025,
        'security_code': '123'
    }
)

Node.js

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

const token = await omise.tokens.create({
  card: {
    name: 'JOHN DOE',
    number: '4242424242424242',
    expiration_month: 12,
    expiration_year: 2025,
    security_code: '123'
  }
});

PHP

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

$token = OmiseToken::create([
    'card' => [
        'name' => 'JOHN DOE',
        'number' => '4242424242424242',
        'expiration_month' => 12,
        'expiration_year' => 2025,
        'security_code' => '123'
    ]
]);

Java

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

Token token = client.tokens().create()
    .card(new Card.Create()
        .name("JOHN DOE")
        .number("4242424242424242")
        .expirationMonth(12)
        .expirationYear(2025)
        .securityCode("123"))
    .send();

C#

var client = new Client("pkey_test_5xuy4w91xqz7d1w9u0t");

var token = await client.Tokens.Create(new CreateTokenRequest
{
    Card = new CardRequest
    {
        Name = "JOHN DOE",
        Number = "4242424242424242",
        ExpirationMonth = 12,
        ExpirationYear = 2025,
        SecurityCode = "123"
    }
});

Go

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

token, _ := client.Tokens().Create(&operations.CreateToken{
    Name:            "JOHN DOE",
    Number:          "4242424242424242",
    ExpirationMonth: 12,
    ExpirationYear:  2025,
    SecurityCode:    "123",
})

---

รหัสข้อผิดพลาดและผลลัพธ์

รหัสข้อผิดพลาดทั่วไป

รหัส	คำอธิบาย	วิธีแก้ไข
bad_request	พารามิเตอร์หายไปหรือไม่ถูกต้อง	ตรวจสอบว่าระบุฟิลด์ที่จำเป็นทั้งหมดแล้ว
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่าคีย์สาธารณะของคุณถูกต้อง
invalid_card	หมายเลขบัตรไม่ถูกต้อง	ตรวจสอบว่าหมายเลขบัตรผ่านการตรวจสอบ Luhn
invalid_expiration_date	บัตรหมดอายุหรือวันที่ไม่ถูกต้อง	ตรวจสอบเดือนและปีหมดอายุ
invalid_security_code	รูปแบบ CVV ไม่ถูกต้อง	ตรวจสอบว่า CVV มี 3-4 หลัก
used_token	โทเค็นถูกใช้แล้ว	สร้างโทเค็นใหม่สำหรับแต่ละการเรียกเก็บเงิน

หมายเลขบัตรทดสอบ

หมายเลขบัตร	ยี่ห้อ	3D Secure
4242424242424242	Visa	ไม่มี
4000000000003063	Visa	มี
5555555555554444	Mastercard	ไม่มี
4111111111111111	Visa	ไม่มี

---

ทดลองใช้งาน

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

▼

card[name](จำเป็น)

card[number](จำเป็น)

card[expiration_month](จำเป็น)

card[expiration_year](จำเป็น)

แนะนำ - 7 ฟิลด์

▼

เพิ่มเติม - 2 ฟิลด์

▼