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

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

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

---

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

▼

---

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

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

▼

`id`STRING(required)

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

Example:"trxn_test_5fzo4nqrnop03djdde1"

---

การตอบกลับ

200

คำขอสำเร็จ

ส่งคืนออบเจ็กต์ธุรกรรมที่ตรงกับ ID ที่ระบุ

ออบเจ็กต์ธุรกรรมประกอบด้วย:

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

401

ไม่ได้รับการยืนยันตัวตน

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

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

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

404

ไม่พบ

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

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

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

---

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

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")

---

ลองใช้งาน

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

▼

id(จำเป็น)