อัปเดตการโอน

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

อัปเดตข้อมูลสถานะการโอน endpoint นี้ส่วนใหญ่ใช้โดย webhook callbacks เพื่ออัปเดตสถานะความสำเร็จ/ความล้มเหลวของการโอนและรายละเอียดที่เกี่ยวข้อง

---

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

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

▼

`id`STRING(required)

รหัสการโอน (เช่น trsf_test_...) ระบุใน URL path

Example:"trsf_test_5xuy4w91xqz7d1w9u0t"

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

▼

`success`BOOLEAN(optional)

ระบุว่าการโอนสำเร็จหรือล้มเหลว

Example:true

`failure_code`STRING(optional)

รหัสที่ระบุประเภทของความล้มเหลว จำเป็นต้องระบุหาก success เป็น false

Example:"insufficient_balance"

Values:insufficient_balance, invalid_recipient, transfers_suspended, transfer_deleted, transfer_sent, transfer_failed

`failure_message`STRING(optional)

คำอธิบายความล้มเหลวที่มนุษย์อ่านได้ ให้บริบทเพิ่มเติมเกี่ยวกับสิ่งที่ผิดพลาด

Example:"Insufficient funds to complete the transfer"

---

การตอบกลับ

200

ธุรกรรมสำเร็จ

อัปเดตการโอนสำเร็จ ส่งคืนอ็อบเจกต์การโอนที่อัปเดตแล้ว

แอตทริบิวต์การโอนที่อัปเดต:

• failure_code - รหัสข้อผิดพลาดหากการโอนล้มเหลว
• failure_message - คำอธิบายความล้มเหลวที่มนุษย์อ่านได้
• แอตทริบิวต์การโอนอื่นๆ ยังคงไม่เปลี่ยนแปลง

400

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

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

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

• ค่า failure_code ไม่ถูกต้อง
• ไม่มี failure_code เมื่อ success เป็น false
• ไม่สามารถอัปเดตการโอนที่เสร็จสมบูรณ์แล้ว

401

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

การรับรองความถูกต้องล้มเหลว API key ไม่ถูกต้องหรือขาดหาย

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

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

404

ไม่พบ

ไม่พบการโอน

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

• รหัสการโอนไม่ถูกต้อง
• การโอนไม่ได้เป็นของบัญชีของคุณ
• การโอนถูกลบแล้ว
• รหัสโหมดทดสอบและโหมดจริงปนกัน

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/transfers/trsf_test_5xuy4w91xqz7d1w9u0t \
  -X PATCH \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "success=false" \
  -d "failure_code=insufficient_balance" \
  -d "failure_message=Insufficient funds to complete the transfer"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

transfer = Omise::Transfer.update('trsf_test_5xuy4w91xqz7d1w9u0t', {
  success: false,
  failure_code: 'insufficient_balance',
  failure_message: 'Insufficient funds to complete the transfer'
})

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

transfer = omise.Transfer.update('trsf_test_5xuy4w91xqz7d1w9u0t',
    success=False,
    failure_code='insufficient_balance',
    failure_message='Insufficient funds to complete the transfer'
)

Node.js

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

const transfer = await omise.transfers.update('trsf_test_5xuy4w91xqz7d1w9u0t', {
  success: false,
  failure_code: 'insufficient_balance',
  failure_message: 'Insufficient funds to complete the transfer'
});

PHP

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

$transfer = OmiseTransfer::retrieve('trsf_test_5xuy4w91xqz7d1w9u0t');
$transfer->update([
    'success' => false,
    'failure_code' => 'insufficient_balance',
    'failure_message' => 'Insufficient funds to complete the transfer'
]);

Java

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

Transfer transfer = client.transfers()
    .update("trsf_test_5xuy4w91xqz7d1w9u0t")
    .success(false)
    .failureCode("insufficient_balance")
    .failureMessage("Insufficient funds to complete the transfer")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var transfer = await client.Transfers.Update("trsf_test_5xuy4w91xqz7d1w9u0t", new UpdateTransferRequest
{
    Success = false,
    FailureCode = "insufficient_balance",
    FailureMessage = "Insufficient funds to complete the transfer"
});

Go

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

transfer, _ := client.Transfers().Update("trsf_test_5xuy4w91xqz7d1w9u0t", &operations.UpdateTransfer{
    Success:        false,
    FailureCode:    "insufficient_balance",
    FailureMessage: "Insufficient funds to complete the transfer",
})

---

รหัสข้อผิดพลาด

รหัสความล้มเหลว

รหัส	คำอธิบาย
insufficient_balance	เงินไม่เพียงพอที่จะโอนให้เสร็จสมบูรณ์
invalid_recipient	ไม่พบรหัสผู้รับหรือไม่ถูกต้อง
transfers_suspended	การโอนถูกปิดใช้งานในบัญชี
transfer_deleted	การโอนถูกลบแล้ว
transfer_sent	การโอนถูกส่งไปแล้ว
transfer_failed	การประมวลผลการโอนล้มเหลว

---

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

▼

ลองใช้งาน

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

▼

id(จำเป็น)

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

▼

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