สร้างการเรียกเก็บเงิน

POSThttps://api.omise.co/charges

สร้างการเรียกเก็บเงินใหม่เพื่อดำเนินการชำระเงิน การเรียกเก็บเงินสามารถสร้างได้โดยใช้โทเค็น (สำหรับบัตรเครดิต) แหล่งที่มา (สำหรับวิธีการชำระเงินทางเลือก) หรือรหัสลูกค้า (สำหรับบัตรที่บันทึกไว้)

---

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

▼

---

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

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

▼

`amount`INTEGER(required)

จำนวนเงินในหน่วยสกุลเงินที่เล็กที่สุด (สตางค์สำหรับ THB, เซนต์สำหรับ USD, เยนสำหรับ JPY) ตัวอย่างเช่น 100000 สตางค์ = 1,000 บาท

Example:100000

Constraints:ขั้นต่ำ: 1 (หน่วยที่เล็กที่สุด), สูงสุด: แตกต่างกันตามวิธีการชำระเงินและสกุลเงิน

`currency`STRING(required)

รหัสสกุลเงิน 3 ตัวอักษรตาม ISO 4217 เป็นตัวพิมพ์เล็ก

Example:"thb"

Values:thb, jpy, sgd, myr, usd, eur, gbp

จำเป็น - 1 จาก 3 ฟิลด์วิธีการชำระเงิน (จำเป็น 1 รายการ)

▼

`card`STRING(optional)

รหัสโทเค็นจาก Omise.js (เช่น tokn_test_...) หรือรหัสบัตรจากลูกค้า (เช่น card_test_...) จำเป็นหาก customer และ source ไม่ได้ระบุ

Example:"tokn_test_5xuy4w91xqz7d1w9u0t"

`source`STRING(optional)

รหัสแหล่งที่มาสำหรับวิธีการชำระเงินทางเลือก เช่น พร้อมเพย์ โมบายแบงก์กิ้ง หรือคิวอาร์โค้ด จำเป็นหาก card และ customer ไม่ได้ระบุ

Example:"src_test_5xuy4w91xqz7d1w9u0t"

`customer`STRING(optional)

รหัสลูกค้า จะเรียกเก็บเงินจากบัตรเริ่มต้นของลูกค้า สามารถใช้ร่วมกับ card เพื่อระบุบัตรเฉพาะได้ จำเป็นหาก card และ source ไม่ได้ระบุ

Example:"cust_test_5xuy4w91xqz7d1w9u0t"

แนะนำ - 5 ฟิลด์พารามิเตอร์ที่แนะนำ

▼

เพิ่มเติม - 5 ฟิลด์พารามิเตอร์เพิ่มเติม

▼

---

การตอบกลับ

200

ธุรกรรมสำเร็จ

สร้างการเรียกเก็บเงินสำเร็จ ตรวจสอบฟิลด์ status เพื่อกำหนดขั้นตอนถัดไป

สถานะการเรียกเก็บเงินที่เป็นไปได้:

• successful - การชำระเงินเสร็จสมบูรณ์สำเร็จ คุณได้รับเงินแล้ว
• pending - การเรียกเก็บเงินยังไม่ได้รับการอนุมัติหรือบันทึก กำลังรอการดำเนินการจากลูกค้า
• failed - การชำระเงินล้มเหลว ตรวจสอบ failure_code และ failure_message เพื่อดูรายละเอียด
• reversed - การเรียกเก็บเงินถูกยกเลิก (การเรียกเก็บเงินที่ยังไม่บันทึกสามารถยกเลิกได้)
• expired - การเรียกเก็บเงินที่รอดำเนินการหมดอายุก่อนการอนุมัติ

400

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

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

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

• ฟิลด์ที่จำเป็นหายไป (amount, currency)
• รหัสสกุลเงินไม่ถูกต้อง
• ไม่มีวิธีการชำระเงินที่ระบุ (card, source, หรือ customer)
• จำนวนเงินไม่ถูกต้อง (ต่ำกว่าขั้นต่ำ)

401

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

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

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

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

402

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

การประมวลผลการชำระเงินล้มเหลว

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

• เงินไม่เพียงพอ
• บัตรถูกปฏิเสธโดยผู้ออกบัตร
• บัตรหมดอายุ
• การยืนยันตัวตน 3D Secure ล้มเหลว
• หมายเลขบัตรหรือ CVV ไม่ถูกต้อง

---

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

cURL

curl https://api.omise.co/charges \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "amount=100000" \
  -d "currency=thb" \
  -d "card=tokn_test_5xuy4w91xqz7d1w9u0t"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

charge = Omise::Charge.create({
  amount: 100000,
  currency: 'thb',
  card: 'tokn_test_5xuy4w91xqz7d1w9u0t'
})

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

charge = omise.Charge.create(
    amount=100000,
    currency='thb',
    card='tokn_test_5xuy4w91xqz7d1w9u0t'
)

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});

const charge = await omise.charges.create({
  amount: 100000,
  currency: 'thb',
  card: 'tokn_test_5xuy4w91xqz7d1w9u0t'
});

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$charge = OmiseCharge::create([
    'amount' => 100000,
    'currency' => 'thb',
    'card' => 'tokn_test_5xuy4w91xqz7d1w9u0t'
]);

Java

Client client = new Client.Builder()
    .secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
    .build();

Charge charge = client.charges().create()
    .amount(100000L)
    .currency("thb")
    .card("tokn_test_5xuy4w91xqz7d1w9u0t")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var charge = await client.Charges.Create(new CreateChargeRequest
{
    Amount = 100000,
    Currency = "thb",
    Card = "tokn_test_5xuy4w91xqz7d1w9u0t"
});

Go

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

charge, _ := client.Charges().Create(&operations.CreateCharge{
    Amount:   100000,
    Currency: "thb",
    Card:     "tokn_test_5xuy4w91xqz7d1w9u0t",
})

---

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

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

Code	คำอธิบาย	วิธีแก้ไข
bad_request	พารามิเตอร์หายไปหรือไม่ถูกต้อง	ตรวจสอบว่าฟิลด์ที่จำเป็นทั้งหมดได้รับการระบุ
authentication_failure	คีย์ API ไม่ถูกต้อง	ตรวจสอบว่าคีย์ลับของคุณถูกต้อง
invalid_card	การตรวจสอบบัตรล้มเหลว	ตรวจสอบหมายเลขบัตร วันหมดอายุ CVV
insufficient_funds	บัตรมีเงินไม่เพียงพอ	ขอวิธีการชำระเงินอื่น
stolen_or_lost_card	บัตรถูกรายงานว่าสูญหาย/ถูกขโมย	การชำระเงินถูกบล็อกเพื่อความปลอดภัย
failed_fraud_check	การตรวจจับการฉ้อโกงล้มเหลว	ติดต่อฝ่ายสนับสนุน Omise

รหัสสถานะการเรียกเก็บเงิน

สถานะ	คำอธิบาย
successful	การชำระเงินเสร็จสมบูรณ์สำเร็จ
pending	กำลังรอการดำเนินการจากลูกค้า (เช่น สแกนคิวอาร์โค้ด)
failed	การชำระเงินล้มเหลว (ดู failure_code)
reversed	การเรียกเก็บเงินถูกยกเลิก/ยกเลิก
expired	การเรียกเก็บเงินหมดอายุก่อนการชำระเงิน

---

ลองใช้งาน

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

▼

amount(จำเป็น)

currency(จำเป็น)

จำเป็น - 1 จาก 3วิธีการชำระเงิน (ต้องเลือก 1 วิธี)

▼

card(ไม่บังคับ)

source(ไม่บังคับ)

customer(ไม่บังคับ)

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

▼

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

▼