อัปเดตลูกค้า

PATCHhttps://api.omise.co/customers/:id

อัปเดตข้อมูลลูกค้าที่มีอยู่ รวมถึงคำอธิบาย, อีเมล, metadata และบัตรเริ่มต้น พารามิเตอร์ทั้งหมดเป็นตัวเลือก - ระบุเฉพาะฟิลด์ที่ต้องการอัปเดต

---

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

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

▼

`id`STRING(required)

Customer ID ที่ต้องการอัปเดต (ต้องขึ้นต้นด้วย cust_)

Example:"cust_test_5xuy4w91xqz7d1w9u0t"

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

เพิ่มเติม - 4 ฟิลด์พารามิเตอร์เพิ่มเติม

▼

---

การตอบกลับ

200

อัปเดตลูกค้าสำเร็จ

ส่งคืน customer object พร้อมข้อมูลที่อัปเดต

พฤติกรรมการอัปเดต:

• เฉพาะฟิลด์ที่ระบุจะถูกอัปเดต
• ฟิลด์ที่ไม่ระบุจะยังคงเดิม
• Metadata จะถูกรวม (ไม่ใช่แทนที่)
• ถ้าระบุ card บัตรใหม่จะถูกเพิ่มและกลายเป็นบัตรเริ่มต้น
• บัตรก่อนหน้ายังคงแนบอยู่แต่ไม่ใช่บัตรเริ่มต้นอีกต่อไป

400

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

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

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

• รูปแบบอีเมลไม่ถูกต้อง
• รูปแบบ metadata ไม่ถูกต้อง
• Metadata เกิน 15,000 ตัวอักษร

401

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

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

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

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

404

ไม่พบ

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

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

• Customer ID ไม่มีอยู่
• Token ID ไม่มีอยู่
• Token ถูกใช้แล้ว

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/customers/cust_test_5xuy4w91xqz7d1w9u0t \
  -X PATCH \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "email=john.updated@example.com" \
  -d "description=John Doe - Premium Member"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

customer = Omise::Customer.update('cust_test_5xuy4w91xqz7d1w9u0t', {
  email: 'john.updated@example.com',
  description: 'John Doe - Premium Member'
})

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

customer = omise.Customer.retrieve('cust_test_5xuy4w91xqz7d1w9u0t')
customer.update(
    email='john.updated@example.com',
    description='John Doe - Premium Member'
)

Node.js

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

const customer = await omise.customers.update('cust_test_5xuy4w91xqz7d1w9u0t', {
  email: 'john.updated@example.com',
  description: 'John Doe - Premium Member'
});

PHP

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

$customer = OmiseCustomer::retrieve('cust_test_5xuy4w91xqz7d1w9u0t');
$customer->update([
    'email' => 'john.updated@example.com',
    'description' => 'John Doe - Premium Member'
]);

Java

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

Customer customer = client.customers().update("cust_test_5xuy4w91xqz7d1w9u0t")
    .email("john.updated@example.com")
    .description("John Doe - Premium Member")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var customer = await client.Customers.Update("cust_test_5xuy4w91xqz7d1w9u0t", new UpdateCustomerRequest
{
    Email = "john.updated@example.com",
    Description = "John Doe - Premium Member"
});

Go

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

customer, _ := client.Customers().Update("cust_test_5xuy4w91xqz7d1w9u0t", &operations.UpdateCustomer{
    Email:       "john.updated@example.com",
    Description: "John Doe - Premium Member",
})

---

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

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

รหัส	คำอธิบาย	วิธีแก้ไข
bad_request	พารามิเตอร์ไม่ถูกต้อง	ตรวจสอบรูปแบบอีเมลและ metadata
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า secret key ถูกต้อง
not_found	ไม่พบลูกค้า	ตรวจสอบว่า customer ID มีอยู่
used_token	Token ถูกใช้แล้ว	สร้าง token ใหม่
invalid_card	Card token ไม่ถูกต้อง	ตรวจสอบว่า token ถูกต้อง

ฟิลด์การอัปเดต

ฟิลด์	คำอธิบาย
email	อีเมลลูกค้าที่อัปเดต
description	คำอธิบายลูกค้าที่อัปเดต
default_card	บัตรเริ่มต้นใหม่ (ถ้าระบุบัตร)
metadata	Metadata object ที่รวมแล้ว
cards	รายการบัตรทั้งหมด (รวมบัตรใหม่ถ้าเพิ่ม)

---

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

▼

ลองใช้งาน

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

▼

id(จำเป็น)

เพิ่มเติม - 4 ฟิลด์

▼

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