ตรวจสอบยอดคงเหลือ

ตรวจสอบยอดคงเหลือในบัญชี

ที่อยู่คำขอ

GET /v1/balance

การยืนยันตัวตน

ใช้ HTTP Basic Authentication เพิ่ม Authorization ใน HTTP Header:

Authorization: Basic ${base64_auth_string}

              
              Authorization: Basic ${base64_auth_string}

โค้ดนี้โชว์เป็นหน้าต่างลอย

base64_auth_string สร้างโดย: base64(dev_key:dev_secret)

ตัวอย่างคำขอ

GET /v1/balance HTTP/1.1 Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

              
              GET /v1/balance  HTTP/1.1
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

โค้ดนี้โชว์เป็นหน้าต่างลอย

Body คำขอ

ไม่มี

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

ไม่มี

พารามิเตอร์การตอบกลับ

การตอบกลับสำเร็จ

ฟิลด์	ประเภท	ตัวเลือก	คำอธิบาย
balance10000	Integer	จำเป็น	ยอดคงเหลือปกติ ค่าจำนวนเต็มคูณด้วย 10000
gift_balance10000	Integer	จำเป็น	ยอดคงเหลือของขวัญ ค่าจำนวนเต็มคูณด้วย 10000
balance	Number	จำเป็น	ยอดคงเหลือปกติ ทศนิยม
gift_balance	Number	จำเป็น	ยอดคงเหลือของขวัญ ทศนิยม
total_balance10000	Integer	จำเป็น	ยอดคงเหลือรวม ผลรวมของยอดคงเหลือปกติและยอดคงเหลือของขวัญ ค่าจำนวนเต็มคูณด้วย 10000
total_balance	Number	จำเป็น	ยอดคงเหลือรวม ผลรวมของยอดคงเหลือปกติและยอดคงเหลือของขวัญ ทศนิยม

{ "balance10000": 123456, "gift_balance10000": 20000, "balance": 12.3456, "gift_balance": 2, "total_balance10000": 143456, "total_balance": 14.3456 }

              
              {
    "balance10000": 123456,
    "gift_balance10000": 20000,
    "balance": 12.3456,
    "gift_balance": 2,
    "total_balance10000": 143456,
    "total_balance": 14.3456
}

โค้ดนี้โชว์เป็นหน้าต่างลอย

แนะนำให้ผู้เรียกใช้ฟิลด์ balance10000, gift_balance10000 และ total_balance10000 เป็นลำดับแรกในการจัดรูปแบบยอดคงเหลือด้วยตนเอง เพื่อหลีกเลี่ยงปัญหาความแม่นยำของทศนิยม

การตอบกลับล้มเหลว

รหัสสถานะ HTTP เป็น 4xx หรือ 5xx เนื้อหาการตอบกลับมีฟิลด์ดังนี้:

ฟิลด์	ประเภท	ตัวเลือก	คำอธิบาย
code	int	จำเป็น	รหัสข้อผิดพลาด ดูรายละเอียดที่ รหัสข้อผิดพลาด
message	String	จำเป็น	รายละเอียดข้อผิดพลาด

{ "code": 2001, "message": "invalid token" }

              
              {
    "code": 2001,
    "message": "invalid token"
}

โค้ดนี้โชว์เป็นหน้าต่างลอย

รหัสข้อผิดพลาด

รหัสข้อผิดพลาด	HTTP Code	คำอธิบาย
1000	500	ข้อผิดพลาดภายใน กรุณาลองใหม่อีกครั้งในภายหลัง
2001	401	การยืนยันตัวตนล้มเหลว ไม่ได้ใส่ token ที่ถูกต้อง หรือ merchant ที่สอดคล้องกับ token ไม่มีอยู่
2002	401	การยืนยันตัวตนล้มเหลว token หมดอายุหรือถูกปิดใช้งาน
2002	403	Merchant ถูกลบแล้ว

ตรวจสอบยอดคงเหลือ