ดึงข้อมูล Source

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

ดึงข้อมูลเกี่ยวกับ Source ที่มีอยู่ (รวมถึงประเภท จำนวนเงิน ข้อมูล QR Code และสถานะการเรียกเก็บเงิน)

---

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

▼

---

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

จำเป็น - 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 - สถานะของการเรียกเก็บเงินที่สร้างด้วย Source (unknown, pending, successful, failed, expired)
• scannable_code - ข้อมูล QR Code (หากมี)
• references - เลขอ้างอิงการชำระเงิน (หากมี)

401

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

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

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

• ขาด Authorization header
• คีย์สาธารณะไม่ถูกต้อง
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

ไม่พบ

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

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

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

---

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

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 ไม่ถูกต้อง	ตรวจสอบว่าคีย์สาธารณะของคุณถูกต้อง
not_found	ไม่พบ Source	ตรวจสอบว่า Source ID ถูกต้องและมีอยู่จริง

ค่าสถานะการเรียกเก็บเงิน

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

---

ลองใช้งาน

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

▼

id(จำเป็น)