สร้างการโอน

POSThttps://api.omise.co/transfers

สร้างการโอนใหม่เพื่อส่งเงินจากยอดคงเหลือในบัญชี Omise ของคุณไปยังบัญชีธนาคารของผู้รับที่ได้รับการยืนยัน การโอนสามารถทำไปยังผู้รับเริ่มต้นหรือผู้รับเฉพาะได้

---

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

แนะนำ - 3 ฟิลด์พารามิเตอร์ที่แนะนำ

▼

`amount`INTEGER(optional)

จำนวนเงินในหน่วยเล็กที่สุดของสกุลเงิน (สตางค์สำหรับ THB, เซนต์สำหรับ USD, เยนสำหรับ JPY) หากไม่ระบุ จะใช้ยอดคงเหลือที่โอนได้ทั้งหมดเป็นค่าเริ่มต้น

Example:100000

Constraints:ค่าต่ำสุด: 1 (หน่วยเล็กที่สุด)

`recipient`STRING(optional)

รหัสผู้รับ (เช่น recp_test_...) หากไม่ระบุ จะใช้ผู้รับเริ่มต้นของบัญชี

Example:"recp_test_5xuy4w91xqz7d1w9u0t"

`metadata`OBJECT(optional)

คู่คีย์-ค่าที่กำหนดเอง (รวมสูงสุด 15,000 ตัวอักษร) มีประโยชน์สำหรับการเก็บการอ้างอิงการโอนหรือข้อมูลที่กำหนดเองอื่นๆ

Example:{"payout_id":"1234","batch":"monthly_payouts"}

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

▼

---

การตอบกลับ

200

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

สร้างการโอนสำเร็จ ตรวจสอบฟิลด์ sent และ paid เพื่อกำหนดสถานะการโอน

ตัวบ่งชี้สถานะการโอน:

• sendable: true - สามารถเริ่มต้นการโอนได้
• sent: true - การโอนถูกส่งไปยังธนาคารแล้ว
• paid: true - การโอนเสร็จสมบูรณ์ ได้รับเงินแล้ว
• failure_code - มีอยู่หากการโอนล้มเหลว (ดูรหัสข้อผิดพลาดด้านล่าง)

400

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

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

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

• รหัสผู้รับไม่ถูกต้อง
• จำนวนเงินไม่ถูกต้อง (เกินยอดคงเหลือที่มี)
• ข้อมูลบัญชีธนาคารขาดหาย
• รูปแบบ metadata ไม่ถูกต้อง

401

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

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

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

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

402

ต้องชำระเงิน

การประมวลผลการโอนล้มเหลว

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

• ยอดคงเหลือไม่เพียงพอ
• ผู้รับไม่ได้รับการยืนยัน
• การโอนถูกระงับในบัญชีของคุณ
• รายละเอียดบัญชีธนาคารไม่ถูกต้อง

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/transfers \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "amount=100000" \
  -d "recipient=recp_test_5xuy4w91xqz7d1w9u0t"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

transfer = Omise::Transfer.create({
  amount: 100000,
  recipient: 'recp_test_5xuy4w91xqz7d1w9u0t'
})

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

transfer = omise.Transfer.create(
    amount=100000,
    recipient='recp_test_5xuy4w91xqz7d1w9u0t'
)

Node.js

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

const transfer = await omise.transfers.create({
  amount: 100000,
  recipient: 'recp_test_5xuy4w91xqz7d1w9u0t'
});

PHP

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

$transfer = OmiseTransfer::create([
    'amount' => 100000,
    'recipient' => 'recp_test_5xuy4w91xqz7d1w9u0t'
]);

Java

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

Transfer transfer = client.transfers().create()
    .amount(100000L)
    .recipient("recp_test_5xuy4w91xqz7d1w9u0t")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var transfer = await client.Transfers.Create(new CreateTransferRequest
{
    Amount = 100000,
    Recipient = "recp_test_5xuy4w91xqz7d1w9u0t"
});

Go

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

transfer, _ := client.Transfers().Create(&operations.CreateTransfer{
    Amount:    100000,
    Recipient: "recp_test_5xuy4w91xqz7d1w9u0t",
})

---

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

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

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

ตัวบ่งชี้สถานะการโอน

ตัวบ่งชี้	คำอธิบาย
sendable: true	การโอนพร้อมที่จะส่ง
sent: true	การโอนถูกส่งไปยังธนาคาร
paid: true	ได้รับเงินเรียบร้อยแล้ว
failure_code	เกิดข้อผิดพลาด (ดูรหัสด้านบน)

---

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

▼

ลองใช้งาน

แนะนำ - 3 ฟิลด์

▼

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

▼

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