เรียกข้อมูลใบเสร็จ

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

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

---

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

▼

---

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

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

▼

`receipt_id`STRING(required)

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

Example:"rcpt_test_5xuy4w91xqz7d1w9u0t"

Constraints:ต้องเป็น ID ใบเสร็จที่ถูกต้อง

---

การตอบกลับ

200

เรียกข้อมูลสำเร็จ

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

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

• id - ตัวระบุใบเสร็จ
• charge_fee - ค่าธรรมเนียมการชาร์จที่สะสม
• transfer_fee - ค่าธรรมเนียมการโอนที่สะสม
• total - จำนวนค่าธรรมเนียมรวม
• currency - รหัสสกุลเงิน
• created_at - ประทับเวลาการสร้าง

401

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

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

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

• ขาดหัวข้อ Authorization
• คีย์ลับไม่ถูกต้อง
• ใช้คีย์สาธารณะแทนคีย์ลับ
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

ไม่พบ

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

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

• รูปแบบ ID ใบเสร็จไม่ถูกต้อง
• ใบเสร็จไม่มีอยู่
• ใบเสร็จเป็นของบัญชีอื่น
• ใช้คีย์ทดสอบกับ ID ใบเสร็จจริง (หรือในทางกลับกัน)

---

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

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

---

รหัสข้อผิดพลาดและผลลัพธ์

รหัสข้อผิดพลาดทั่วไป

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

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

ฟิลด์	ประเภท	คำอธิบาย
object	string	ส่งคืน "receipt" เสมอ
id	string	ตัวระบุใบเสร็จที่ไม่ซ้ำกัน
livemode	boolean	ตัวบ่งชี้สภาพแวดล้อมจริงหรือทดสอบ
charge_fee	integer	ค่าธรรมเนียมการชาร์จของ Omise ในหน่วยสกุลเงินที่เล็กที่สุด
transfer_fee	integer	ค่าธรรมเนียมการโอนในหน่วยสกุลเงินที่เล็กที่สุด
subtotal	integer	ยอดรวมย่อยก่อนหักภาษี
vat	integer	จำนวนภาษีมูลค่าเพิ่ม
wht	integer	จำนวนภาษีหัก ณ ที่จ่าย
total	integer	ยอดรวมที่คำนวณเป็น subtotal + vat - wht
currency	string	รหัส ISO 4217 สามตัวอักษร
created_at	string	ประทับเวลาการสร้าง (ISO 8601)

---

ลองใช้งาน

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

▼

receipt_id(จำเป็น)