🏦 BankService (7 APIs)
API สำหรับจัดการธนาคาร — ค้นหาธนาคาร, บัญชีฝากเงิน, ตรวจสลิป, QR Code, อั่งเปา
1. ค้นหาธนาคาร (Search Bank)
Authorization
| Type | Key | Value |
|---|---|---|
| Bearer Token | Authorization | Bearer <token> |
Request
GET {{ENDPOINT}}/member-hook/bank?query={keyword}
Query Parameters
| Parameter | ตัวอย่าง | คำอธิบาย |
|---|---|---|
query | กสิกร | คำค้นหาชื่อธนาคาร (ถ้าไม่ส่ง = ดึงทั้งหมด) |
Example
Request
curl -X GET '{{ENDPOINT}}/member-hook/bank?query=กสิกร' \
-H 'Authorization: Bearer <token>'
Response 200 OK
{
"data": [
{
"_id": "65a1b2c3d4e5f6a7b8c9d0e1",
"bank_name": "ธนาคารกสิกรไทย",
"bank_code": "KBANK",
"bank_logo": "https://cdn.example.com/kbank.png"
}
]
}
2. ดึงบัญชีธนาคารฝากเงิน (Get Deposit Bank Account)
Authorization
| Type | Key | Value |
|---|---|---|
| Bearer Token | Authorization | Bearer <token> |
Request
GET {{ENDPOINT}}/member-hook/bank-account
Example
Request
curl -X GET '{{ENDPOINT}}/member-hook/bank-account' \
-H 'Authorization: Bearer <token>'
Response 200 OK
{
"data": [
{
"_id": "65b2c3d4e5f6a7b8c9d0e1f2",
"bank_name": "ธนาคารกสิกรไทย",
"account_number": "123-456-7890",
"account_name": "บริษัท ทดสอบ จำกัด"
}
]
}
3. ดึงบัญชีธนาคาร v2 (Bank Account Setting Visible)
Authorization
| Type | Key | Value |
|---|---|---|
| Bearer Token | Authorization | Bearer <token> |
Request
POST {{ENDPOINT}}/member-hook/bank-account/v2
Body application/json
| Field | ตัวอย่าง | คำอธิบาย |
|---|---|---|
member_id | "64a1b2c3d4e5f6a7b8c9d0e1" | ID ของสมาชิก |
Example
Request
curl -X POST '{{ENDPOINT}}/member-hook/bank-account/v2' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"member_id": "64a1b2c3d4e5f6a7b8c9d0e1"
}'
Response 200 OK
{
"data": [
{
"_id": "65b2c3d4e5f6a7b8c9d0e1f2",
"bank_name": "ธนาคารกสิกรไทย",
"account_number": "123-456-7890",
"visible": true
}
]
}
4. ตรวจสอบสลิป (Verify Statement Slip)
Authorization
| Type | Key | Value |
|---|---|---|
| Bearer Token | Authorization | Bearer <token> |
Request
POST {{ENDPOINT}}/statement/verify/slip
Body application/json
| Field | ตัวอย่าง | คำอธิบาย |
|---|---|---|
slip_image | "data:image/png;base64,iVBOR..." | รูปสลิปเป็น Base64 |
member_id | "64a1b2c3d4e5f6a7b8c9d0e1" | ID ของสมาชิก |
Example
Request
curl -X POST '{{ENDPOINT}}/statement/verify/slip' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"slip_image": "data:image/png;base64,iVBOR...",
"member_id": "64a1b2c3d4e5f6a7b8c9d0e1"
}'
Response 200 OK
{
"status": true,
"amount": 100,
"bank": "KBANK",
"ref_number": "20240115ABC123"
}
5. สร้าง QR Code ฝากเงิน (Deposit QR Code)
Authorization
| Type | Key | Value |
|---|---|---|
| Bearer Token | Authorization | Bearer <token> |
Request
POST {{ENDPOINT}}/member-hook/deposit-qr
Body application/json
| Field | ตัวอย่าง | คำอธิบาย |
|---|---|---|
member_id | "64a1b2c3d4e5f6a7b8c9d0e1" | ID ของสมาชิก |
amount | 100 | จำนวนเงิน |
Example
Request
curl -X POST '{{ENDPOINT}}/member-hook/deposit-qr' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"member_id": "64a1b2c3d4e5f6a7b8c9d0e1",
"amount": 100
}'
Response 200 OK
{
"status": true,
"qr_code": "data:image/png;base64,iVBOR...",
"ref_number": "QR20240115001",
"expire_at": "2024-01-15T11:00:00.000Z"
}