ดึงข้อมูล Source

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

ดึงข้อมูลเกี่ยวกับ source ที่มีอยู่ รวมถึงประเภท จำนวนเงิน ข้อมูล QR code และสถานะ charge

---

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

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

▼

`id`STRING(required)

Source ID ที่ต้องการดึงข้อมูล ต้องขึ้นต้นด้วย src_ ตามด้วย test_ หรือ live_ และตัวระบุที่ไม่ซ้ำกัน

Example:"src_test_5xuy4w91xqz7d1w9u0t"

Constraints:ต้องเป็น source ID ที่ถูกต้อง, รูปแบบ: src_(test|live)_[0-9a-z]+

---

การตอบกลับ

200

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

ดึงข้อมูล source สำเร็จ ส่งคืน source object พร้อมรายละเอียดทั้งหมด

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

• id - ตัวระบุ Source
• type - ประเภทวิธีการชำระเงิน
• flow - ขั้นตอนการชำระเงิน (offline, redirect, app_redirect)
• amount - จำนวนเงินของ source
• currency - รหัสสกุลเงิน
• charge_status - สถานะของ charge ที่สร้างด้วย source (unknown, pending, successful, failed, expired)
• scannable_code - ข้อมูล QR code ถ้ามี
• references - ข้อมูลอ้างอิงการชำระเงินถ้ามี
• created_at - Timestamp การสร้าง source (ISO 8601)

401

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

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

สาเหตุที่พบบ่อย:

• ไม่มี Authorization header
• Public key ไม่ถูกต้อง
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

ไม่พบ

ไม่พบ source Source ID ที่ระบุไม่มีอยู่

สาเหตุที่พบบ่อย:

• รูปแบบ source ID ไม่ถูกต้อง
• Source ID ไม่มีอยู่ในบัญชีของคุณ
• ใช้ test key เพื่อเข้าถึง live source (หรือในทางกลับกัน)
• พิมพ์ source ID ผิด

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/sources/src_test_5xuy4w91xqz7d1w9u0t \
  -u pkey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'pkey_test_5xuy4w91xqz7d1w9u0t'

source = Omise::Source.retrieve('src_test_5xuy4w91xqz7d1w9u0t')

Python

import omise

omise.api_public = 'pkey_test_5xuy4w91xqz7d1w9u0t'

source = omise.Source.retrieve('src_test_5xuy4w91xqz7d1w9u0t')

Node.js

const omise = require('omise')({
  publicKey: 'pkey_test_5xuy4w91xqz7d1w9u0t'
});

const source = await omise.sources.retrieve('src_test_5xuy4w91xqz7d1w9u0t');

PHP

<?php
define('OMISE_PUBLIC_KEY', 'pkey_test_5xuy4w91xqz7d1w9u0t');

$source = OmiseSource::retrieve('src_test_5xuy4w91xqz7d1w9u0t');

Java

Client client = new Client.Builder()
    .publicKey("pkey_test_5xuy4w91xqz7d1w9u0t")
    .build();

Source source = client.sources().get("src_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("pkey_test_5xuy4w91xqz7d1w9u0t");

var source = await client.Sources.Get("src_test_5xuy4w91xqz7d1w9u0t");

Go

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

source, _ := client.Sources().Get("src_test_5xuy4w91xqz7d1w9u0t")

---

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

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

รหัส	คำอธิบาย	วิธีแก้ไข
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า public key ของคุณถูกต้อง
not_found	ไม่พบ source	ตรวจสอบว่า source ID ถูกต้องและมีอยู่

ค่าสถานะ Charge

สถานะ	คำอธิบาย
unknown	ยังไม่มี charge ที่สร้างด้วย source นี้
pending	การชำระเงินรอการดำเนินการจากลูกค้า
successful	การชำระเงินเสร็จสมบูรณ์
failed	การชำระเงินล้มเหลว
expired	การชำระเงินหมดอายุก่อนเสร็จสมบูรณ์

---

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

▼

ทดลองใช้

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

▼

id(จำเป็น)

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