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

POSThttps://api.omise.co/transfers

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

---

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

▼

---

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

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

▼

`amount`INTEGER(required)

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

Example:85000

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

`recipient`STRING(required)

Recipient ID เพื่อรับการโอน ต้องเป็นผู้รับที่ยืนยันแล้ว

Example:"recp_test_5xuy4w91xqz7d1w9u0t"

แนะนำ - 1 ฟิลด์พารามิเตอร์แนะนำ

▼

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

▼

---

การตอบกลับ

200

สร้างสำเร็จ

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

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

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

400

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

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

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

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

401

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

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

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

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

422

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

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

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

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

5xx

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

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

วิธีจัดการ:

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

---

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

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 key ไม่ถูกต้อง	ตรวจสอบว่า secret key ถูกต้อง
insufficient_balance	ยอดเงินไม่เพียงพอสำหรับการโอน	ตรวจสอบยอดเงินในบัญชี
recipient_not_verified	ผู้รับไม่ได้รับการยืนยัน	ผู้รับต้องได้รับการยืนยันก่อนรับการโอน
recipient_inactive	ผู้รับไม่ได้ใช้งาน	ตรวจสอบสถานะผู้รับ

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

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

---

ลองใช้งาน

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

▼

amount(จำเป็น)

recipient(จำเป็น)

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

▼

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

▼

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