ข้ามไปยังเนื้อหาหลัก
เวอร์ชัน: ล่าสุด

อัปเดตบัญชี

อัปเดตและส่งคืนข้อมูลบัญชี ใช้ endpoint นี้เพื่อกำหนดค่า webhook endpoints, การตั้งค่า metadata export และพารามิเตอร์ marketplace


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

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

แนะนำ - 4 รายการพารามิเตอร์ที่แนะนำ
`webhook_uri`STRING(optional)
Primary webhook endpoint URL สำหรับรับการแจ้งเตือนเหตุการณ์ ต้องเป็น HTTPS ใน live mode
Example:"https://example.com/webhooks/omise"
`chain_enabled`BOOLEAN(optional)
เปิดใช้งาน account chaining (ฟีเจอร์ marketplace) หรือไม่
Example:false
Default:false
`chain_return_uri`STRING(optional)
Return URI เริ่มต้นสำหรับธุรกรรม marketplace หลังจากลูกค้าอนุมัติ
Example:"https://marketplace.example.com/return"
`zero_interest_installments`BOOLEAN(optional)
ร้านค้ารับภาระค่าดอกเบี้ยผ่อนชำระหรือไม่ (ผ่อนชำระ 0% สำหรับลูกค้า)
Example:false
Default:false
เพิ่มเติม - 1 รายการพารามิเตอร์เพิ่มเติม

การตอบกลับ

200

อัปเดตสำเร็จ

ส่งคืน account object ที่อัปเดตแล้วพร้อมรายละเอียดการกำหนดค่าทั้งหมด

Account object ที่อัปเดตประกอบด้วย:
  • id - ตัวระบุบัญชี
  • webhook_uri - Webhook URL ที่อัปเดต
  • chain_enabled - สถานะการเปิดใช้งาน marketplace ที่อัปเดต
  • chain_return_uri - Return URI ของ marketplace ที่อัปเดต
  • zero_interest_installments - การตั้งค่าผ่อนชำระที่อัปเดต
  • metadata_export_keys - การกำหนดค่า metadata export ที่อัปเดต
  • fields บัญชีอื่นๆ ทั้งหมด (email, country, currency ฯลฯ)

400

Bad request

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

สาเหตุทั่วไป:
  • รูปแบบ webhook URL ไม่ถูกต้อง
  • HTTP webhook URL ใน live mode (ต้องเป็น HTTPS)
  • โครงสร้าง metadata_export_keys ไม่ถูกต้อง
  • ประเภทพารามิเตอร์ไม่ถูกต้อง

401

Unauthorized

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

5xx

Server error

เกิดข้อผิดพลาดฝั่งเซิร์ฟเวอร์ ลอง request ใหม่ด้วย exponential backoff


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

curl https://api.omise.co/account \
-X PATCH \
-u skey_test_5xuy4w91xqz7d1w9u0t: \
-d "webhook_uri=https://example.com/webhooks/omise"

ลองใช้งาน

แนะนำ - 4 ฟิลด์
เพิ่มเติม - 1 ฟิลด์
IP ของคุณ: ...กำลังโหลด...