ดึงข้อมูลบัญชี Chain

GEThttps://api.omise.co/chains/{id}/account

ดึงข้อมูลบัญชีสำหรับการเชื่อมต่อ chain ส่งคืนรายละเอียดเกี่ยวกับบัญชี sub-merchant ที่เชื่อมโยงกับ chain นี้ รวมถึงข้อมูลธุรกิจและสถานะบัญชี

---

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

▼

---

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

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

▼

`id`STRING(required)

ตัวระบุ Chain ตรงกับรูปแบบ /acch(_test)?_[0-9a-z]+/ ระบุใน URL path

Example:"acch_test_5xuy4w91xqz7d1w9u0t"

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

---

การตอบกลับ

200

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

ดึงข้อมูลบัญชี chain สำเร็จ ส่งคืน account object พร้อมรายละเอียดธุรกิจและการยืนยัน

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

• id - ตัวระบุบัญชี
• email - ที่อยู่อีเมลบัญชี
• team - ชื่อทีมที่เชื่อมโยงกับบัญชี
• currency - สกุลเงินเริ่มต้นสำหรับบัญชี
• supported_currencies - รายการสกุลเงินที่รองรับ
• created_at - เวลาสร้างบัญชี

400

คำขอไม่ถูกต้อง

การตรวจสอบคำขอล้มเหลว ตรวจสอบข้อความข้อผิดพลาดสำหรับรายละเอียด

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

• รูปแบบ chain ID ไม่ถูกต้อง
• คำขอผิดรูปแบบ

401

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

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

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

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

404

ไม่พบ

ไม่พบ chain หรือบัญชีด้วย ID ที่ระบุ

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

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

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/chains/acch_test_5xuy4w91xqz7d1w9u0t/account \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

chain = Omise::Chain.retrieve('acch_test_5xuy4w91xqz7d1w9u0t')
account = chain.account

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

chain = omise.Chain.retrieve('acch_test_5xuy4w91xqz7d1w9u0t')
account = chain.account()

Node.js

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

const account = await omise.chains.retrieveAccount('acch_test_5xuy4w91xqz7d1w9u0t');

PHP

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

$chain = OmiseChain::retrieve('acch_test_5xuy4w91xqz7d1w9u0t');
$account = $chain->account();

Java

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

Account account = client.chains().getAccount("acch_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var account = await client.Chains.GetAccount("acch_test_5xuy4w91xqz7d1w9u0t");

Go

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

account, _ := client.Chains().GetAccount("acch_test_5xuy4w91xqz7d1w9u0t")

---

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

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

รหัส	คำอธิบาย	วิธีแก้ไข
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า secret key ถูกต้อง
not_found	ไม่พบ chain หรือบัญชี	ตรวจสอบว่า chain ID ถูกต้องและมีอยู่
invalid_chain_id	Chain ID ผิดรูปแบบ	ตรวจสอบให้ ID ตรงกับรูปแบบ acch(test)?[0-9a-z]+
chain_revoked	การเข้าถึง chain ถูกเพิกถอนแล้ว	ไม่สามารถเข้าถึงบัญชีสำหรับ chains ที่ถูกเพิกถอน

ฟิลด์ Account Object

ฟิลด์	ประเภท	คำอธิบาย
object	string	ส่งคืน "account" เสมอ
id	string	ตัวระบุบัญชีที่ไม่ซ้ำกัน
email	string	ที่อยู่อีเมลบัญชี
team	string	ชื่อทีมที่เชื่อมโยงกับบัญชี
currency	string	สกุลเงินเริ่มต้นสำหรับบัญชี (เช่น "thb")
supported_currencies	array	รายการสกุลเงินที่บัญชีนี้รองรับ
livemode	boolean	ตัวบ่งชี้สภาพแวดล้อม production vs test
created_at	string	เวลาสร้างบัญชี (ISO 8601)

---

ลองใช้งาน

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