สร้างการโอนเงิน

POSThttps://api.omise.co/transfers

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

---

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

▼

---

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

Recommended - 3 fieldsRecommended Parameters

▼

`amount`INTEGER(optional)

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

Example:100000

Constraints:Minimum: 1 (smallest unit)

`recipient`STRING(optional)

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

Example:"recp_test_5xuy4w91xqz7d1w9u0t"

`metadata`OBJECT(optional)

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

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

Additional - 2 fieldsAdditional Parameters

▼

---

การตอบกลับ

200

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

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

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

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

400

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

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

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

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

401

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

การยืนยันตัวตนล้มเหลว คีย์ API ไม่ถูกต้องหรือขาดหายไป

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

• ขาดส่วนหัว Authorization
• คีย์ลับไม่ถูกต้อง
• ใช้คีย์สาธารณะแทนคีย์ลับ
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

402

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

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

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

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

---

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

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",
})

---

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

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

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

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

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

---

ลองใช้งาน

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

▼

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

▼