แสดงรายการธุรกรรม

GEThttps://api.omise.co/transactions

ส่งคืนรายการธุรกรรมแบบแบ่งหน้าที่เป็นของบัญชีของคุณ ธุรกรรมแสดงถึงการเคลื่อนไหวของเงินระหว่างบัญชีของคุณกับแหล่งที่มาของการชำระเงินหรือปลายทางการโอน

---

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

▼

---

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

Recommended - 5 fieldsRecommended Parameters

▼

`from`STRING(optional)

วันที่และเวลา UTC เก่าสุดของระเบียนที่ส่งคืน (รูปแบบ ISO 8601) ใช้เพื่อกรองธุรกรรมที่สร้างขึ้นหลังจากวันที่นี้

Example:"2025-01-01T00:00:00Z"

Default:"1970-01-01T00:00:00Z"

`to`STRING(optional)

วันที่และเวลา UTC ล่าสุดของระเบียนที่ส่งคืน (รูปแบบ ISO 8601) ใช้เพื่อกรองธุรกรรมที่สร้างขึ้นก่อนวันที่นี้

Example:"2025-12-31T23:59:59Z"

`limit`INTEGER(optional)

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

Example:20

Constraints:Minimum: 1, Maximum: 100

Default:20

`offset`INTEGER(optional)

จำนวนระเบียนที่จะข้ามก่อนส่งคืนผลลัพธ์ ใช้ร่วมกับ limit สำหรับการแบ่งหน้า

Example:0

Default:0

`order`STRING(optional)

ลำดับการเรียงผลลัพธ์ตามเวลาที่สร้าง

Example:"chronological"

Values:chronological, reverse_chronological

Default:"chronological"

---

การตอบกลับ

200

คำขอสำเร็จ

ส่งคืนออบเจ็กต์รายการที่มีข้อมูลธุรกรรมในอาร์เรย์ data

โครงสร้างการตอบกลับ:

• object - ค่าสตริง "list"
• data - อาร์เรย์ของออบเจ็กต์ธุรกรรม
• limit - จำนวนระเบียนต่อหน้า
• offset - ออฟเซ็ตปัจจุบัน
• total - จำนวนธุรกรรมทั้งหมด
• location - เส้นทางของ API endpoint

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

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

401

ไม่ได้รับการรับรองความถูกต้อง

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

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

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

---

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

cURL

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

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

transactions = Omise::Transaction.list

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

transactions = omise.Transaction.retrieve()

Node.js

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

const transactions = await omise.transactions.list();

PHP

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

$transactions = OmiseTransaction::retrieve();

Java

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

ScopedList<Transaction> transactions = client.transactions().list();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var transactions = await client.Transactions.List();

Go

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

transactions, _ := client.Transactions().List(&operations.ListTransactions{
    Limit: 20,
})

---

ทดลองใช้งาน

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

▼