ทำเครื่องหมายการโอนว่าส่งแล้ว

POSThttps://api.omise.co/transfers/:id/mark_as_sent

ทำเครื่องหมายการโอนว่าส่งแล้ว endpoint นี้ใช้เพื่อระบุว่าการโอนถูกส่งไปยังธนาคารเพื่อประมวลผลแล้ว เมื่อทำเครื่องหมายว่าส่งแล้ว สถานะการโอนจะได้รับการอัปเดตและแฟล็ก sent จะถูกตั้งค่าเป็น true

---

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

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

▼

`id`STRING(required)

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

Example:"trsf_test_5xuy4w91xqz7d1w9u0t"

---

การตอบกลับ

200

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

ทำเครื่องหมายการโอนว่าส่งแล้วสำเร็จ ส่งคืนอ็อบเจกต์การโอนที่อัปเดตแล้วพร้อม sent: true

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

• sent - ตั้งค่าเป็น true แล้ว
• sent_at - timestamp เมื่อทำเครื่องหมายว่าส่งแล้ว
• แอตทริบิวต์การโอนอื่นๆ ยังคงไม่เปลี่ยนแปลง

400

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

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

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

• การโอนถูกทำเครื่องหมายว่าส่งแล้ว
• การโอนไม่สามารถส่งได้ (ยอดคงเหลือไม่เพียงพอ ผู้รับไม่ถูกต้อง)
• การโอนถูกลบแล้ว
• การโอนอยู่ในสถานะไม่ถูกต้อง

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/mark_as_sent \
  -X POST \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

transfer = Omise::Transfer.retrieve('trsf_test_5xuy4w91xqz7d1w9u0t')
transfer.mark_as_sent

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

transfer = omise.Transfer.retrieve('trsf_test_5xuy4w91xqz7d1w9u0t')
transfer.mark_as_sent()

Node.js

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

const transfer = await omise.transfers.markAsSent('trsf_test_5xuy4w91xqz7d1w9u0t');

PHP

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

$transfer = OmiseTransfer::retrieve('trsf_test_5xuy4w91xqz7d1w9u0t');
$transfer->mark_as_sent();

Java

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

Transfer transfer = client.transfers()
    .markAsSent("trsf_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var transfer = await client.Transfers.MarkAsSent("trsf_test_5xuy4w91xqz7d1w9u0t");

Go

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

transfer, _ := client.Transfers().MarkAsSent("trsf_test_5xuy4w91xqz7d1w9u0t")

---

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

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

รหัส	คำอธิบาย	การแก้ไข
transfer_already_sent	การโอนถูกทำเครื่องหมายว่าส่งแล้ว	ไม่ต้องดำเนินการ การโอนส่งไปแล้ว
transfer_not_sendable	การโอนไม่สามารถส่งได้	ตรวจสอบสถานะ sendable ของการโอนและแก้ไขปัญหา
transfer_deleted	การโอนถูกลบแล้ว	ไม่สามารถทำเครื่องหมายการโอนที่ถูกลบว่าส่งแล้ว
invalid_transfer_state	การโอนอยู่ในสถานะไม่ถูกต้อง	ตรวจสอบสถานะการโอนปัจจุบัน
insufficient_balance	เงินไม่เพียงพอที่จะส่งการโอน	รอให้การเรียกเก็บเงินผ่านหรือลดจำนวนเงิน

---

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

▼

ลองใช้งาน

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

▼

id(จำเป็น)

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