ดึงข้อมูล Transfer

GEThttps://api.omise.co/transfers/:id

ดึงข้อมูลรายละเอียดของ transfer ที่ระบุโดยใช้ ID ระบบจะส่งคืนออบเจ็กต์ transfer ที่มีสถานะ จำนวนเงิน ข้อมูลผู้รับ และเวลาที่บันทึก

---

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

▼

---

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

Required - 1 fieldRequired Parameters

▼

`id`STRING(required)

Transfer ID (เช่น trsf_test_...) ระบุในพาธของ URL

Example:"trsf_test_5xuy4w91xqz7d1w9u0t"

---

การตอบกลับ

200

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

ดึงข้อมูล Transfer สำเร็จ ระบบจะส่งคืนออบเจ็กต์ transfer ที่สมบูรณ์พร้อมทุกคุณสมบัติ

คุณสมบัติของ transfer ที่ส่งคืน:

• id - ตัวระบุ Transfer
• amount - จำนวนเงิน transfer ในหน่วยสกุลเงินที่เล็กที่สุด
• currency - รหัสสกุลเงิน ISO 4217 ตัวอักษร 3 ตัว
• recipient - ออบเจ็กต์ Recipient หรือ ID
• bank_account - รายละเอียดบัญชีธนาคารปลายทาง
• sent, paid - ตัวบอกสถานะ
• created_at, sent_at, paid_at - เวลาที่บันทึก

401

ไม่ได้รับการยืนยันตัวตน

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

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

• ขาดหายไป Authorization header
• secret key ไม่ถูกต้อง
• ใช้ public key แทน secret key
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

ไม่พบ

ไม่พบ Transfer

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

• transfer ID ไม่ถูกต้อง
• Transfer ไม่ได้เป็นของบัญชีของคุณ
• Transfer ถูกลบแล้ว
• ผสม ID ของโหมดทดสอบและโหมดจริง

---

Code samples

cURL

curl https://api.omise.co/transfers/trsf_test_5xuy4w91xqz7d1w9u0t \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

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

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

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

Node.js

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

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

PHP

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

$transfer = OmiseTransfer::retrieve('trsf_test_5xuy4w91xqz7d1w9u0t');

Java

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

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

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

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

Go

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

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

---

ลองใช้งาน

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

▼

id(จำเป็น)