ดึงข้อมูลใบเสร็จ

GEThttps://api.omise.co/receipts/:receipt_id

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

---

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

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

▼

`receipt_id`STRING(required)

ตัวระบุใบเสร็จที่ตรงกับรูปแบบ /rcpt(_test)?_[0-9a-z]+/ ระบุใน URL path

Example:"rcpt_test_5xuy4w91xqz7d1w9u0t"

Constraints:ต้องเป็น receipt ID ที่ถูกต้อง

---

การตอบกลับ

200

ดึงข้อมูลสำเร็จ

ดึงข้อมูลใบเสร็จสำเร็จ ส่งคืนออบเจกต์ใบเสร็จที่สมบูรณ์พร้อมรายละเอียดทั้งหมด

Response รวมถึง:

• object - ค่า "receipt"
• id - ตัวระบุใบเสร็จ (rcpt_*)
• livemode - โหมด live หรือ test
• location - เส้นทาง API ไปยังออบเจกต์ใบเสร็จ
• adjustment_transaction - ID ธุรกรรมการปรับปรุงที่เกี่ยวข้อง
• charge_fee - ค่าธรรมเนียม charge สะสมในหน่วยสกุลเงินที่เล็กที่สุด
• company_address - ที่อยู่บริษัท Omise
• company_name - ชื่อบริษัท Omise
• company_tax_id - เลขประจำตัวผู้เสียภาษีบริษัท Omise
• credit_note - ว่านี่คือใบลดหนี้หรือไม่
• currency - รหัสสกุลเงิน ISO 4217 3 ตัวอักษร
• customer_address - ที่อยู่ร้านค้า
• customer_email - อีเมลร้านค้า
• customer_name - ชื่อร้านค้า
• customer_statement_name - ชื่อ statement ร้านค้า
• customer_tax_id - เลขประจำตัวผู้เสียภาษีร้านค้า
• issued_on - วันที่ออกใบเสร็จ
• number - เลขที่ใบเสร็จ
• subtotal - ยอดรวมย่อยก่อนภาษีในหน่วยสกุลเงินที่เล็กที่สุด
• total - จำนวนเงินรวม (subtotal + vat - wht)
• transaction_fee - ค่าธรรมเนียมธุรกรรมในหน่วยสกุลเงินที่เล็กที่สุด
• transfer_fee - ค่าธรรมเนียมการโอนในหน่วยสกุลเงินที่เล็กที่สุด
• vat - จำนวน VAT ในหน่วยสกุลเงินที่เล็กที่สุด
• voided_fee - จำนวนค่าธรรมเนียมที่ถูกยกเลิกในหน่วยสกุลเงินที่เล็กที่สุด
• wht - จำนวนภาษีหัก ณ ที่จ่ายในหน่วยสกุลเงินที่เล็กที่สุด
• created_at - timestamp การสร้างใบเสร็จ (ISO 8601)

401

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

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

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

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

404

ไม่พบ

ไม่พบใบเสร็จด้วย ID ที่ระบุ

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

• รูปแบบ receipt ID ไม่ถูกต้อง
• ใบเสร็จไม่มีอยู่
• ใบเสร็จเป็นของบัญชีอื่น
• ใช้ test key กับ live receipt ID (หรือกลับกัน)

5xx

เซิร์ฟเวอร์ error

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

วิธีจัดการ:

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

---

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

cURL

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

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

receipt = Omise::Receipt.retrieve('rcpt_test_5xuy4w91xqz7d1w9u0t')

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

receipt = omise.Receipt.retrieve('rcpt_test_5xuy4w91xqz7d1w9u0t')

Node.js

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

const receipt = await omise.receipts.retrieve('rcpt_test_5xuy4w91xqz7d1w9u0t');

PHP

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

$receipt = OmiseReceipt::retrieve('rcpt_test_5xuy4w91xqz7d1w9u0t');

Java

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

Receipt receipt = client.receipts().get("rcpt_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var receipt = await client.Receipts.Get("rcpt_test_5xuy4w91xqz7d1w9u0t");

Go

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

receipt, _ := client.Receipts().Get("rcpt_test_5xuy4w91xqz7d1w9u0t")

---

รหัส Error และผลลัพธ์

รหัส Error ทั่วไป

รหัส	คำอธิบาย	วิธีแก้ไข
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า secret key ถูกต้อง
not_found	ไม่พบใบเสร็จ	ตรวจสอบว่า receipt ID ถูกต้องและมีอยู่
invalid_receipt_id	receipt ID ไม่ถูกต้อง	ตรวจสอบให้แน่ใจว่า ID ตรงกับรูปแบบ rcpt(test)?[0-9a-z]+

ฟิลด์ออบเจกต์ใบเสร็จ

ฟิลด์	ประเภท	คำอธิบาย
object	string	ส่งคืน "receipt" เสมอ
id	string	ตัวระบุใบเสร็จเฉพาะ (rcpt_*)
livemode	boolean	ตัวบ่งชี้สภาพแวดล้อม production หรือ test
location	string	เส้นทาง API ไปยังออบเจกต์ใบเสร็จ
adjustment_transaction	string	ID ธุรกรรมการปรับปรุงที่เกี่ยวข้อง
charge_fee	integer	ค่าธรรมเนียม charge ของ Omise ในหน่วยสกุลเงินที่เล็กที่สุด
company_address	string	ที่อยู่บริษัท Omise
company_name	string	ชื่อบริษัท Omise
company_tax_id	string	เลขประจำตัวผู้เสียภาษีบริษัท Omise
credit_note	boolean	ว่านี่คือใบลดหนี้หรือไม่
currency	string	รหัส ISO 4217 3 ตัวอักษร
customer_address	string	ที่อยู่ร้านค้า
customer_email	string	อีเมลร้านค้า
customer_name	string	ชื่อร้านค้า
customer_statement_name	string	ชื่อ statement ร้านค้า
customer_tax_id	string	เลขประจำตัวผู้เสียภาษีร้านค้า
issued_on	string	วันที่ออกใบเสร็จ
number	string	เลขที่ใบเสร็จ
subtotal	integer	ยอดรวมย่อยก่อนภาษี
total	integer	ยอดรวม (คำนวณเป็น subtotal + vat - wht)
transaction_fee	integer	ค่าธรรมเนียมธุรกรรมในหน่วยสกุลเงินที่เล็กที่สุด
transfer_fee	integer	ค่าธรรมเนียมการโอนในหน่วยสกุลเงินที่เล็กที่สุด
vat	integer	จำนวน VAT
voided_fee	integer	จำนวนค่าธรรมเนียมที่ถูกยกเลิก
wht	integer	จำนวนภาษีหัก ณ ที่จ่าย
created_at	string	timestamp การสร้าง (ISO 8601)

---

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

▼

ลองใช้งาน

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

▼

receipt_id(จำเป็น)

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