ลบบัตร

DELETEhttps://api.omise.co/customers/:id/cards/:card_id

ลบบัตรออกจากบัญชีลูกค้าอย่างถาวร การดำเนินการนี้ไม่สามารถย้อนกลับได้

---

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

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

▼

`id`STRING(required)

Customer ID (ต้องเป็น customer ID ที่ถูกต้องและขึ้นต้นด้วย cust_)

Example:"cust_test_5xuy4w91xqz7d1w9u0t"

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

`card_id`STRING(required)

Card ID ที่ต้องการลบ (ต้องเป็น card ID ที่ถูกต้องและขึ้นต้นด้วย card_)

Example:"card_test_5xuy4w91xqz7d1w9u0t"

Constraints:ต้องเป็น card ID ที่ถูกต้อง, บัตรต้องเป็นของลูกค้า

---

การตอบกลับ

200

ลบบัตรสำเร็จ

ลบบัตรออกจากบัญชีลูกค้าอย่างถาวรแล้ว

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

• บัตรถูกลบออกจากลูกค้าอย่างถาวร
• รายละเอียดบัตรไม่สามารถเข้าถึงได้อีกต่อไป
• บัตรไม่สามารถใช้สำหรับการเรียกเก็บเงินในอนาคต
• การเรียกเก็บเงินในอดีตยังคงอยู่ในบันทึกแต่ฟิลด์บัตรจะเป็น null
• ถ้านี่เป็นบัตรเริ่มต้น default_card ของลูกค้าจะเป็น null
• การลบไม่สามารถยกเลิกได้

400

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

รูปแบบ customer ID หรือ card ID ไม่ถูกต้อง

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

• รูปแบบ ID ไม่ถูกต้อง
• IDs ไม่ได้ขึ้นต้นด้วย cust_ หรือ card_

401

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

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

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

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

404

ไม่พบ

ไม่พบลูกค้าหรือบัตร

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

• Customer ID ไม่มีอยู่
• Card ID ไม่มีอยู่
• บัตรไม่ได้เป็นของลูกค้าที่ระบุ
• บัตรถูกลบไปแล้ว

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/customers/cust_test_5xuy4w91xqz7d1w9u0t/cards/card_test_5xuy4w91xqz7d1w9u0t \
  -X DELETE \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

card = Omise::Card.destroy(
  'card_test_5xuy4w91xqz7d1w9u0t',
  customer_id: 'cust_test_5xuy4w91xqz7d1w9u0t'
)

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

customer = omise.Customer.retrieve('cust_test_5xuy4w91xqz7d1w9u0t')
card = customer.destroy_card('card_test_5xuy4w91xqz7d1w9u0t')

Node.js

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

const card = await omise.customers.destroyCard(
  'cust_test_5xuy4w91xqz7d1w9u0t',
  'card_test_5xuy4w91xqz7d1w9u0t'
);

PHP

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

$customer = OmiseCustomer::retrieve('cust_test_5xuy4w91xqz7d1w9u0t');
$card = $customer->destroyCard('card_test_5xuy4w91xqz7d1w9u0t');

Java

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

Card card = client.customer("cust_test_5xuy4w91xqz7d1w9u0t")
    .card("card_test_5xuy4w91xqz7d1w9u0t")
    .destroy();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var card = await client.Customers.DestroyCard(
    "cust_test_5xuy4w91xqz7d1w9u0t",
    "card_test_5xuy4w91xqz7d1w9u0t"
);

Go

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

deleted, _ := client.Cards().DestroyCard(
    "cust_test_5xuy4w91xqz7d1w9u0t",
    "card_test_5xuy4w91xqz7d1w9u0t",
)

---

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

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

รหัส	คำอธิบาย	วิธีแก้ไข
bad_request	รูปแบบ ID ไม่ถูกต้อง	ตรวจสอบรูปแบบ customer และ card ID
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า secret key ถูกต้อง
not_found	ไม่พบลูกค้าหรือบัตร	ตรวจสอบว่า IDs มีอยู่และบัตรเป็นของลูกค้า
conflict	ไม่สามารถลบบัตรที่กำลังใช้งาน	รอให้การเรียกเก็บเงินที่รอดำเนินการเสร็จสิ้น

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

ฟิลด์	คำอธิบาย
object	ประเภท object (เป็น "card" เสมอ)
id	ID ของบัตรที่ลบ
deleted	Boolean flag (เป็น true เสมอสำหรับการลบที่สำเร็จ)
livemode	ว่านี่เป็นบัตร live mode หรือไม่

---

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

▼

ลองใช้งาน

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

▼

id(จำเป็น)

card_id(จำเป็น)

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