เพิกถอน Chain

POSThttps://api.omise.co/chains/{id}/revoke

เพิกถอนการเชื่อมต่อ chain ที่มีอยู่ การดำเนินการนี้ยุติการอนุญาตและป้องกันบัญชีที่ร้องขอจากการสร้างการเรียกเก็บเงินหรือดำเนินการในนามของ sub-merchant การดำเนินการนี้ไม่สามารถยกเลิกได้

---

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

▼

---

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

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

▼

`id`STRING(required)

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

Example:"acch_test_5xuy4w91xqz7d1w9u0t"

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

---

การตอบกลับ

200

เพิกถอนสำเร็จ

เพิกถอน chain สำเร็จ การเชื่อมต่อ chain ถูกยุติแล้วและบัญชีที่ร้องขอไม่สามารถดำเนินการในนามของ sub-merchant ได้อีกต่อไป

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

• id - ตัวระบุ Chain
• key - คีย์การยืนยันตัวตน (ไม่ถูกต้องแล้ว)
• email - อีเมลบัญชี sub-merchant
• revoked - จะเป็น true หลังจากเพิกถอน
• livemode - ตัวบ่งชี้สภาพแวดล้อม production vs test
• created_at - เวลาสร้าง

400

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

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

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

• รูปแบบ chain ID ไม่ถูกต้อง
• Chain ถูกเพิกถอนแล้ว
• Chain มีการโอนที่รอดำเนินการ

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 (หรือกลับกัน)

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/chains/acch_test_5xuy4w91xqz7d1w9u0t/revoke \
  -X POST \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

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

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

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

Node.js

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

const chain = await omise.chains.revoke('acch_test_5xuy4w91xqz7d1w9u0t');

PHP

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

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

Java

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

Chain chain = client.chains().revoke("acch_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var chain = await client.Chains.Revoke("acch_test_5xuy4w91xqz7d1w9u0t");

Go

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

chain, _ := client.Chains().Revoke("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]+
already_revoked	Chain ถูกเพิกถอนแล้ว	Chain ถูกเพิกถอนแล้ว
pending_transfers	Chain มีการโอนที่รอดำเนินการ	รอให้การโอนที่รอดำเนินการเสร็จสิ้น

ฟิลด์ Chain Object

ฟิลด์	ประเภท	คำอธิบาย
object	string	ส่งคืน "chain" เสมอ
id	string	ตัวระบุ chain ที่ไม่ซ้ำกัน
key	string	คีย์การยืนยันตัวตน (ไม่ถูกต้องหลังจากเพิกถอน)
email	string	อีเมลบัญชี sub-merchant
livemode	boolean	ตัวบ่งชี้สภาพแวดล้อม production vs test
revoked	boolean	จะเป็น true หลังจากเพิกถอน
created_at	string	เวลาสร้าง (ISO 8601)

---

ลองใช้งาน

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