ลบ Linked Account

DELETEhttps://api.omise.co/linked_accounts/:id

ลบ linked account จากแพลตฟอร์มของคุณอย่างถาวร การกระทำนี้ไม่สามารถย้อนกลับได้และ linked account จะไม่สามารถใช้สำหรับการชำระเงินได้อีก

---

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

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

▼

`id`STRING(required)

Linked Account ID ที่จะลบ (ต้องเป็น linked account ID ที่ถูกต้องและขึ้นต้นด้วย lacct_)

Example:"lacct_test_5xuy4w91xqz7d1w9u0t"

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

---

การตอบกลับ

200

ลบ linked account สำเร็จ

ลบ Linked account อย่างถาวรแล้ว บัญชีไม่สามารถใช้สำหรับการชำระเงินได้อีก

ผลกระทบจากการลบ:

• สถานะ linked account ถูกตั้งค่าเป็น "deleted"
• บัญชีไม่สามารถประมวลผลการชำระเงินได้อีก
• Registration URI กลายเป็นไม่ถูกต้อง
• ธุรกรรมที่ผ่านมายังคงอยู่ในบันทึก
• การลบไม่สามารถยกเลิกได้

400

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

รูปแบบ linked account ID ไม่ถูกต้อง

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

• รูปแบบ linked account ID ไม่ถูกต้อง
• ID ไม่ขึ้นต้นด้วย lacct_

401

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

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

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

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

404

ไม่พบ

ไม่พบ Linked account

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

• Linked account ID ไม่มีอยู่
• Linked account ถูกลบไปแล้ว
• Linked account ไม่ได้เป็นของแพลตฟอร์มของคุณ
• ใช้ IDs โหมด test และ live ผสมกัน

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/linked_accounts/lacct_test_5xuy4w91xqz7d1w9u0t \
  -X DELETE \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

linked_account = Omise::LinkedAccount.destroy('lacct_test_5xuy4w91xqz7d1w9u0t')

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

linked_account = omise.LinkedAccount.retrieve('lacct_test_5xuy4w91xqz7d1w9u0t')
linked_account.destroy()

Node.js

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

const linkedAccount = await omise.linkedAccounts.destroy('lacct_test_5xuy4w91xqz7d1w9u0t');

PHP

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

$linked_account = OmiseLinkedAccount::retrieve('lacct_test_5xuy4w91xqz7d1w9u0t');
$linked_account->destroy();

Java

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

LinkedAccount linkedAccount = client.linkedAccounts().destroy("lacct_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var linkedAccount = await client.LinkedAccounts.Destroy("lacct_test_5xuy4w91xqz7d1w9u0t");

Go

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

deleted, _ := client.LinkedAccounts().Destroy("lacct_test_5xuy4w91xqz7d1w9u0t")

---

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

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

รหัส	คำอธิบาย	วิธีแก้ไข
bad_request	รูปแบบ linked account ID ไม่ถูกต้อง	ตรวจสอบรูปแบบ ID
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบ secret key ของคุณ
not_found	ไม่พบ linked account	ตรวจสอบว่า linked account ID มีอยู่

การตอบกลับการลบ

ฟิลด์	คำอธิบาย
object	ประเภทอ็อบเจกต์ (เป็น "linked_account" เสมอ)
id	ID ของ linked account ที่ถูกลบ
livemode	เป็น linked account โหมด live หรือไม่
status	สถานะ (เป็น "deleted" เสมอสำหรับการลบที่สำเร็จ)
deleted	แฟล็กบูลีน (เป็น true เสมอสำหรับการลบที่สำเร็จ)

---

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

▼

ทดลองใช้งาน

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

▼

id(จำเป็น)

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