สร้างการโอนเงินพร้อม chain

POSThttps://api.omise.co/transfers

สร้างการโอนเงินด้วยพารามิเตอร์ merchant_id เพื่อเชื่อมโยงกับ charge chain ซึ่งช่วยให้สามารถทำการโอนเงินบนมาร์เก็ตเพลซด้วยตนเองพร้อมควบคุมเวลาและจำนวนเงินได้อย่างเต็มที่

---

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

▼

---

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

Required - 2 fieldsพารามิเตอร์ที่จำเป็น

▼

`amount`INTEGER(required)

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

Example:85000

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

`recipient`STRING(required)

รหัสผู้รับเงินที่จะรับการโอน ต้องเป็นผู้รับเงินที่ได้รับการยืนยันแล้ว

Example:"recp_test_5xuy4w91xqz7d1w9u0t"

Recommended - 1 fieldพารามิเตอร์ที่แนะนำ

▼

Additional - 1 fieldพารามิเตอร์เพิ่มเติม

▼

---

การตอบกลับ

200

สร้างสำเร็จ

สร้างการโอนเงินสำเร็จ การโอนจะถูกส่งไปยังบัญชีธนาคารของผู้รับภายใน 24 ชั่วโมง

การตอบกลับประกอบด้วย:

• id - รหัสการโอนเงิน
• amount - จำนวนเงินโอน
• recipient - รหัสผู้รับเงิน
• sent - ส่งไปยังธนาคารแล้วหรือไม่
• paid - ผู้รับได้รับเงินแล้วหรือไม่

400

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

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

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

• ขาดฟิลด์ที่จำเป็น (amount, recipient)
• จำนวนเงินไม่ถูกต้อง (เป็นลบหรือเป็นศูนย์)
• รูปแบบรหัสผู้รับเงินไม่ถูกต้อง
• รูปแบบ merchant_id (รหัสการเรียกเก็บเงิน) ไม่ถูกต้อง

401

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

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

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

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

422

ไม่สามารถประมวลผลได้

ไม่สามารถประมวลผลการโอนได้เนื่องจากข้อจำกัดทางธุรกิจ

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

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

---

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

cURL

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

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

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

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

transfer = omise.Transfer.create(
    amount=85000,
    recipient='recp_test_5xuy4w91xqz7d1w9u0t',
    merchant_id='chrg_test_5xuy4w91xqz7d1w9u0t'
)

Node.js

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

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

PHP

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

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

Java

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

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

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

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

Go

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

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

---

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

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

รหัส	คำอธิบาย	วิธีแก้ไข
bad_request	พารามิเตอร์ขาดหายหรือไม่ถูกต้อง	ตรวจสอบให้แน่ใจว่ามีฟิลด์ที่จำเป็นทั้งหมด
authentication_failure	รหัส API ไม่ถูกต้อง	ตรวจสอบว่ารหัสลับของคุณถูกต้อง
insufficient_balance	ยอดคงเหลือไม่เพียงพอสำหรับการโอน	ตรวจสอบยอดคงเหลือในบัญชี
recipient_not_verified	ผู้รับเงินยังไม่ได้รับการยืนยัน	ผู้รับเงินต้องได้รับการยืนยันก่อนรับการโอน
recipient_inactive	ผู้รับเงินไม่ใช้งาน	ตรวจสอบสถานะผู้รับเงิน

ฟิลด์สถานะการโอนเงิน

ฟิลด์	คำอธิบาย
sent	ส่งไปยังธนาคารแล้วหรือไม่ (false = รอดำเนินการ, true = ส่งแล้ว)
paid	ผู้รับได้รับเงินแล้วหรือไม่ (false = กำลังโอน, true = เสร็จสมบูรณ์)
sent_at	เวลาที่ส่งการโอนไปยังธนาคาร
paid_at	เวลาที่ผู้รับได้รับเงิน

---

ลองใช้งาน

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

▼

amount(จำเป็น)

recipient(จำเป็น)

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

▼

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

▼