ดึงข้อมูลธุรกรรม

GEThttps://api.omise.co/transactions/:id

ส่งคืนธุรกรรมที่ตรงกับ ID ที่ระบุ ใช้ endpoint นี้เพื่อดึงข้อมูลรายละเอียดเกี่ยวกับธุรกรรมที่ระบุสำหรับการกระทบยอดหรือการตรวจสอบ

---

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

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

▼

`id`STRING(required)

ตัวระบุธุรกรรม รูปแบบ: trxn_test_[0-9a-z]+ สำหรับโหมดทดสอบ หรือ trxn_[0-9a-z]+ สำหรับโหมดใช้งานจริง

Example:"trxn_test_5fzo4nqrnop03djdde1"

---

การตอบกลับ

200

คำขอสำเร็จ

ส่งคืน transaction object ที่ตรงกับ ID ที่ระบุ

Transaction object ประกอบด้วย:

• id - ตัวระบุธุรกรรม (เช่น trxn_test_5fzo4nqrnop03djdde1)
• object - ค่า string "transaction"
• amount - จำนวนเงินธุรกรรมในหน่วยสกุลเงินที่เล็กที่สุด
• currency - รหัสสกุลเงิน ISO 4217 สามตัวอักษร
• direction - ทิศทางของเงิน (credit หรือ debit)
• key - object ที่เกี่ยวข้องที่ทำให้เกิดธุรกรรม
• origin - แหล่งที่มาเดิมของธุรกรรม
• transferable_at - วันที่และเวลา ISO 8601 ที่เงินสามารถโอนได้
• created_at - timestamp การสร้างธุรกรรม (ISO 8601)
• livemode - ค่า boolean ระบุโหมดใช้งานจริงหรือทดสอบ
• location - เส้นทาง API สำหรับดึงธุรกรรมนี้

401

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

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

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

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

404

ไม่พบ

ไม่พบธุรกรรม

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

• Transaction ID ไม่ถูกต้อง
• Transaction ID จากบัญชีอื่น
• ใช้ IDs โหมดทดสอบและโหมดใช้งานจริงปนกัน

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/transactions/trxn_test_5fzo4nqrnop03djdde1 \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

transaction = Omise::Transaction.retrieve('trxn_test_5fzo4nqrnop03djdde1')

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

transaction = omise.Transaction.retrieve('trxn_test_5fzo4nqrnop03djdde1')

Node.js

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

const transaction = await omise.transactions.retrieve('trxn_test_5fzo4nqrnop03djdde1');

PHP

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

$transaction = OmiseTransaction::retrieve('trxn_test_5fzo4nqrnop03djdde1');

Java

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

Transaction transaction = client.transactions().get("trxn_test_5fzo4nqrnop03djdde1");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var transaction = await client.Transactions.Get("trxn_test_5fzo4nqrnop03djdde1");

Go

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

transaction, _ := client.Transactions().Get("trxn_test_5fzo4nqrnop03djdde1")

---

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

▼

ทดลองใช้งาน

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

▼

id(จำเป็น)

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