สร้างการเรียกเก็บเงินพร้อม chain

POSThttps://api.omise.co/charges

สร้างการเรียกเก็บเงินพร้อมพารามิเตอร์ destination เพื่อเปิดใช้งานการแบ่งการชำระเงิน marketplace ซึ่งสร้าง chain ที่เชื่อมโยงการเรียกเก็บเงินกับการโอนอัตโนมัติไปยังผู้รับ

---

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

▼

---

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

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

▼

`amount`INTEGER(required)

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

Example:100000

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

`currency`STRING(required)

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

Example:"thb"

Values:thb, jpy, sgd, myr, usd

`destination`STRING(required)

Recipient ID เพื่อรับการโอนอัตโนมัติหลังจากการเรียกเก็บเงินสำเร็จ จำเป็นสำหรับการแบ่งการชำระเงิน marketplace

Example:"recp_test_5xuy4w91xqz7d1w9u0t"

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

▼

`card`STRING(optional)

Token ID จาก Omise.js (เช่น tokn_test_...) หรือ card ID จากลูกค้า (เช่น card_test_...) จำเป็นถ้าไม่มี customer และ source

Example:"tokn_test_5xuy4w91xqz7d1w9u0t"

`source`STRING(optional)

Source ID สำหรับวิธีชำระเงินทางเลือกเช่น PromptPay, mobile banking หรือ QR codes จำเป็นถ้าไม่มี card และ customer

Example:"src_test_5xuy4w91xqz7d1w9u0t"

`customer`STRING(optional)

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

Example:"cust_test_5xuy4w91xqz7d1w9u0t"

แนะนำ - 2 ฟิลด์พารามิเตอร์แนะนำ

▼

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

▼

---

การตอบกลับ

200

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

สร้างการเรียกเก็บเงินพร้อม chain สำเร็จ การโอนอัตโนมัติจะถูกสร้างไปยังผู้รับ destination หลังจากการเรียกเก็บเงินสำเร็จ

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

• destination - Recipient ID สำหรับการโอนอัตโนมัติ
• chain - Chain ID ที่เชื่อมโยงการเรียกเก็บเงินกับการโอน
• platform_fee - รายละเอียดค่าคอมมิชชั่นแพลตฟอร์ม
• status - สถานะการเรียกเก็บเงิน (successful, pending, failed ฯลฯ)

400

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

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

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

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

401

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

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

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

• ไม่มี Authorization header
• Secret key ไม่ถูกต้อง
• ใช้ public key แทน secret key
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

5xx

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

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

วิธีจัดการ:

• ลองส่งคำขอใหม่ด้วย exponential backoff
• ตรวจสอบเหตุการณ์บริการที่ status.omise.co
• ดูการจัดการข้อผิดพลาดสำหรับคำแนะนำโดยละเอียด

---

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

cURL

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

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

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

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

charge = omise.Charge.create(
    amount=100000,
    currency='thb',
    card='tokn_test_5xuy4w91xqz7d1w9u0t',
    destination='recp_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',
  destination: 'recp_test_5xuy4w91xqz7d1w9u0t'
});

PHP

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

$charge = OmiseCharge::create([
    'amount' => 100000,
    'currency' => 'thb',
    'card' => 'tokn_test_5xuy4w91xqz7d1w9u0t',
    'destination' => 'recp_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")
    .destination("recp_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",
    Destination = "recp_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",
    Destination: "recp_test_5xuy4w91xqz7d1w9u0t",
})

---

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

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

รหัส	คำอธิบาย	วิธีแก้ไข
bad_request	พารามิเตอร์ไม่มีหรือไม่ถูกต้อง	ตรวจสอบว่าฟิลด์ที่จำเป็นทั้งหมดมี
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า secret key ถูกต้อง
invalid_recipient	Destination recipient ID ไม่ถูกต้อง	ตรวจสอบว่าผู้รับมีอยู่และใช้งานอยู่
recipient_not_verified	ผู้รับไม่ได้รับการยืนยัน	ผู้รับต้องได้รับการยืนยันก่อนรับการโอน

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

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

---

ลองใช้งาน

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

▼

amount(จำเป็น)

currency(จำเป็น)

destination(จำเป็น)

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

▼

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

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

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

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

▼

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

▼

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