สร้างการชาร์จด้วย chain

POSThttps://api.omise.co/charges

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

---

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

▼

---

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

Required - 3 fieldsพารามิเตอร์ที่จำเป็น

▼

`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

`destination`STRING(required)

ID ของผู้รับที่จะได้รับการโอนอัตโนมัติหลังจากการชาร์จสำเร็จ จำเป็นสำหรับการแบ่งเงินการชำระเงินใน marketplace

Example:"recp_test_5xuy4w91xqz7d1w9u0t"

Required - 1 of 3 fieldsวิธีการชำระเงิน (จำเป็น 1 รายการ)

▼

`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 Code จำเป็นหาก card และ customer ไม่ได้ระบุ

Example:"src_test_5xuy4w91xqz7d1w9u0t"

`customer`STRING(optional)

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

Example:"cust_test_5xuy4w91xqz7d1w9u0t"

Recommended - 2 fieldsพารามิเตอร์ที่แนะนำ

▼

Additional - 1 fieldพารามิเตอร์เพิ่มเติม

▼

---

การตอบกลับ

200

สำเร็จ

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

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

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

400

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

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

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

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

401

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

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

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

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

---

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

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	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 ฟิลด์

▼