Search Payment Transaction
Service Name: | Search Payment Transaction |
URL: | [SANDBOX] https://sandbox-api-transaction.chillpay.co/api/v1/payment/search |
[PROD] https://api-transaction.chillpay.co/api/v1/payment/search | |
Method: | POST |
Description: | เป็นเซอร์วิสในการค้นหารายการชำระเงิน (Payment Transactions) – ร้านค้าหลักสามารถค้นหาข้อมูลของร้านค้าย่อยได้ – ร้านค้าย่อยสามารถค้นหาได้เฉพาะร้านค้าตนเองเท่านั้น |
ตารางที่ 1.1 Request Header Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | Content-Type | String | 16 | M | application/json |
2 | CHILLPAY-MerchantCode | String | 15 | M | รหัสร้านค้าที่ออกให้โดยชิวเพย์ |
3 | CHILLPAY-ApiKey | String | 100 | M | รหัสอ้างอิงที่ออกให้โดยชิวเพย์ ใช้ในการเชื่อมต่อระบบ |
ตารางที่ 1.2 Request Body Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | OrderBy | String | 20 | O | เรียงตามคอลัมน์- TransactionId- TransactionDate- Merchant- Customer- OrderNo- PaymentChannel- PaymentDate- Amount- Fee- Discount- TotalAmount- RouteNo- Status- Settled* หากไม่ได้ส่งมาค่าเริ่มต้นคือ ” TransactionId” |
2 | OrderDir | String | 4 | O | การเรียงลำดับASC : เรียงจากน้อยไปมากDESC : เรียงจากมากไปน้อย* หากไม่ได้ส่งมาค่าเริ่มต้นคือ DESC |
3 | PageSize | Number | O | จำนวนรายการต่อหน้า (1-100)* หากไม่ได้ส่งมาค่าเริ่มต้นคือ 10 | |
4 | PageNumber | Number | O | เลขหน้า* หากไม่ได้ส่งมาค่าเริ่มต้นคือ 1 | |
5 | SearchKeyword | String | 255 | O | คำหรือข้อความที่ต้องการค้นหา |
6 | MerchantCode | String | 15 | O | รหัสร้านค้าที่ต้องการค้นหา* หากไม่ได้ส่งมาค่าเริ่มต้นคือ ร้านค้าทั้งหมด |
7 | PaymentChannel | String | 30 | O | ช่องทางการชำระเงิน ภาคผนวก ข. |
8 | RouteNo | Number | O | เส้นทางชำระเงิน | |
9 | OrderNo | String | 20 | O | เลขที่อ้างอิงรายการของทางร้านค้า |
10 | Status | String | 20 | O | สถานะการชำระเงิน ภาคผนวก ก. |
11 | TransactionDateFrom | String | 19 | O | วันที่ทำรายการ (จาก) [dd/MM/yyyy HH:mm:ss] |
12 | TransactionDateTo | String | 19 | O | วันที่ทำรายการ (ถึง) [dd/MM/yyyy HH:mm:ss] |
13 | PaymentDateFrom | String | 19 | O | วันที่ชำระเงิน (จาก) [dd/MM/yyyy HH:mm:ss] |
14 | PaymentDateTo | String | 19 | O | วันที่ชำระเงิน (ถึง) [dd/MM/yyyy HH:mm:ss] |
15 | Checksum | String | 32 | M | ผลลัพธ์ที่ได้จากการนำค่าทั้งหมดไปเข้ารหัส |
ตัวอย่าง การเรียก Request Search Payment Transaction (Code ภาษา C# .NET)
var client = new RestClient("https://api-transaction.chillpay.co/api/v1/payment/search");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("CHILLPAY-MerchantCode", "xxx");
request.AddHeader("CHILLPAY-ApiKey", "xxx");
request.AddHeader("Content-Type", "application/json");
var body = @"{""OrderBy"": ""TransactionId"", ""OrderDir"": ""DESC"", ""PageSize"": null, ""PageNumber"": null, ""SearchKeyword"": null, ""MerchantCode"": null, ""PaymentChannel"": ""Credit Card"", ""RouteNo"": null, ""OrderNo"": null, ""Status"": null, ""TransactionDateFrom"": ""01/02/2021 00:00:00"", ""TransactionDateTo"": null, ""PaymentDateFrom"": null, ""PaymentDateTo"": null, ""Checksum"": ""c3b4619ec90e3d8c09da69262e398d7e""}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
หมายเหตุ
- ค่า Checksum เป็นการนำค่าจาก Parameter ตามตารางที่ 1.2 (ข้อ 1-14) มาเรียงต่อกัน แล้วต่อท้ายด้วย MD5 Secret Key (ที่ได้รับจากทางชิวเพย์) ดังนี้
- OrderBy + OrderDir + PageSize + PageNumber + SearchKeyword + MerchantCode + PaymentChannel + RouteNo + OrderNo + Status + TransactionDateFrom + TransactionDateTo + PaymentDateFrom + PaymentDateTo + MD5 Secret Key
- จากนั้นนำข้อมูลที่เรียงกันทั้งหมดนี้ไปเข้ารหัสด้วยฟังก์ชั่น MD5 Hashing จึงจะได้เป็นค่า Checksum
- ตัวอย่าง การนำข้อมูลมาเรียงต่อกันเพื่อเข้าฟังก์ชั่น MD5TransactionIdDESCCredit
- Card01/02/2021 00:00:00AAABBBCCCDDD
ตารางที่ 1.3 Response Message Parameters
No. | Parameters Name | Data Type | Description |
---|---|---|---|
1 | totalRecord | Number | จำนวนรายการทั้งหมด |
2 | pageSize | Number | จำนวนรายการต่อหน้า |
3 | pageNumber | Number | เลขหน้า |
4 | filteredRecord | Number | จำนวนรายการในหน้าปัจจุบัน |
5 | status | String | รหัสสถานะการทำรายการ ภาคผนวก ค. |
6 | message | String | คำอธิบายสถานะการทำรายการ |
7 | data[].transactionId | Number | เลขที่อ้างอิงรายการของทางชิวเพย์ |
8 | data[].transactionDate | String | วันที่ทำรายการ [dd/MM/yyyy HH:mm:ss] |
9 | data[].merchant | String | ชื่อร้านค้า |
10 | data[].customer | String | รหัสอ้างอิงหรือชื่อลูกค้า |
11 | data[].orderNo | String | เลขที่อ้างอิงรายการของทางร้านค้า |
12 | data[].paymentChannel | String | ช่องทางการชำระเงิน |
13 | data[].paymentDate | String | วันที่ชำระเงิน [dd/MM/yyyy HH:mm:ss] |
14 | data[].amount | String | ค่าสินค้าหรือบริการ [#,##0.00] |
15 | data[].fee | String | ค่าธรรมเนียม [#,##0.00] |
16 | data[].discount | String | ส่วนลด [#,##0.00] |
17 | data[].totalAmount | String | ราคารวม [#,##0.00] |
18 | data[].currency | String | สกุลเงิน |
19 | data[].routeNo | Number | เส้นทางชำระเงิน |
20 | data[].status | String | สถานะการชำระเงิน |
21 | data[].settled | Boolean | สถานะการโอนเงินให้ร้านค้า [True, False] |
ตัวอย่าง ข้อมูล JSON Response Message ที่ได้รับจากการเรียก API
{
"totalRecord": 264,
"pageSize": 10,
"pageNumber": 1,
"filteredRecord": 10,
"status": 200,
"message": "Success",
"data": [
{
"transactionId": 115309,
"transactionDate": "03/03/2022 15:27:53",
"merchant": "Bank Industries",
"customer": "AA",
"orderNo": "O1",
"paymentChannel": "Credit Card",
"paymentDate": "03/03/2022 15:28:11",
"amount": "5,000.00",
"fee": "15.00",
"discount": "0.00",
"totalAmount": "5,015.00",
"currency": "THB",
"routeNo": 3,
"status": "Fail",
"settled": false
},
...
]
}
Search Settlement Transaction
Service Name: | Search Settlement Transaction |
URL: | [SANDBOX] https://sandbox-api-transaction.chillpay.co/api/v1/settlement/search |
[PROD] https://api-transaction.chillpay.co/api/v1/settlement/search | |
Method: | POST |
Description: | เป็นเซอร์วิสในการค้นหารายการโอนเงินคืนร้านค้า (Settlement Transactions) – รายการที่จะแสดงสูงสุดคือรายการของวันปัจจุบัน -1 – ร้านค้าหลักสามารถค้นหาข้อมูลของร้านค้าย่อยได้ – ร้านค้าย่อยสามารถค้นหาได้เฉพาะร้านค้าตนเองเท่านั้น |
ตารางที่ 2.1 Request Header Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
1 | Content-Type | String | 16 | M | application/json |
2 | CHILLPAY-MerchantCode | String | 15 | M | รหัสร้านค้าที่ออกให้โดยชิวเพย์ |
3 | CHILLPAY-ApiKey | String | 100 | M | รหัสอ้างอิงที่ออกให้โดยชิวเพย์ ใช้ในการเชื่อมต่อระบบ |
ตารางที่ 2.2 Request Body Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
1 | OrderBy | String | 20 | O | เรียงตามคอลัมน์- TransactionId- TransactionDate- PaymentDate- Merchant- Customer- OrderNo- PaymentChannel- Amount- Fee- NetAmount- ExchangeRate- Settled- Discount- RouteNo* หากไม่ได้ส่งมาค่าเริ่มต้นคือ TransactionId |
2 | OrderDir | String | 4 | O | การเรียงลำดับASC : เรียงจากน้อยไปมากDESC : เรียงจากมากไปน้อย* หากไม่ได้ส่งมาค่าเริ่มต้นคือ DESC |
3 | PageSize | Number | O | จำนวนรายการต่อหน้า (1-100)* หากไม่ได้ส่งมาค่าเริ่มต้นคือ 10 | |
4 | PageNumber | Number | O | เลขหน้า* หากไม่ได้ส่งมาค่าเริ่มต้นคือ 1 | |
5 | SearchKeyword | String | 255 | O | คำหรือข้อความที่ต้องการค้นหา |
6 | MerchantCode | String | 15 | O | รหัสร้านค้าที่ต้องการค้นหา* หากไม่ได้ส่งมาค่าเริ่มต้นคือ ร้านค้าทั้งหมด |
7 | PaymentChannel | String | 30 | O | ช่องทางการชำระเงิน ภาคผนวก ข. |
8 | RouteNo | Number | O | เส้นทางชำระเงิน | |
9 | OrderNo | String | 20 | O | เลขที่อ้างอิงรายการของทางร้านค้า |
10 | Settled | Boolean | O | สถานะการโอนเงินให้ร้านค้า [True, False] | |
11 | TransactionDateFrom | String | 19 | O | วันที่ทำรายการ (จาก) [dd/MM/yyyy HH:mm:ss] |
12 | TransactionDateTo | String | 19 | O | วันที่ทำรายการ (ถึง) [dd/MM/yyyy HH:mm:ss] |
13 | PaymentDateFrom | String | 19 | O | วันที่ชำระเงิน (จาก) [dd/MM/yyyy HH:mm:ss] |
14 | PaymentDateTo | String | 19 | O | วันที่ชำระเงิน (ถึง) [dd/MM/yyyy HH:mm:ss] |
15 | Checksum | String | 32 | M | ผลลัพธ์ที่ได้จากการนำค่าทั้งหมดไปเข้ารหัส |
ตัวอย่าง การเรียก Request Search Settlement Transaction (Code ภาษา C# .NET)
var client = new RestClient("https://api-transaction.chillpay.co/api/v1/settlement/search");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("CHILLPAY-MerchantCode", "xxx");
request.AddHeader("CHILLPAY-ApiKey", "xxx");
request.AddHeader("Content-Type", "application/json");
var body = @"{""OrderBy"": ""TransactionId"", ""OrderDir"": ""DESC"", ""PageSize"": null, ""PageNumber"": null, ""SearchKeyword"": null, ""MerchantCode"": null, ""PaymentChannel"": null, ""RouteNo"": null, ""OrderNo"": null, ""Settled"": true, ""TransactionDateFrom"": null, ""TransactionDateTo"": null, ""PaymentDateFrom"": null, ""PaymentDateTo"": null, ""Checksum"": ""380eb9dff5f97b1c705030ee922959e6""}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
หมายเหตุ
- ค่า Checksum เป็นการนำค่าจาก Parameter ตามตารางที่ 2.2 (ข้อ 1-14) มาเรียงต่อกัน แล้วต่อท้ายด้วย MD5 Secret Key (ที่ได้รับจากทางชิวเพย์) ดังนี้
- OrderBy + OrderDir + PageSize + PageNumber + SearchKeyword + MerchantCode + PaymentChannel + RouteNo + OrderNo + Settled + TransactionDateFrom + TransactionDateTo + PaymentDateFrom + PaymentDateTo + MD5 Secret Key
- จากนั้นนำข้อมูลที่เรียงกันทั้งหมดนี้ไปเข้ารหัสด้วยฟังก์ชั่น MD5 Hashing จึงจะได้เป็นค่า Checksum
- ตัวอย่าง การนำข้อมูลมาเรียงต่อกันเพื่อเข้าฟังก์ชั่น MD5
- TransactionIdDESCTrueAAABBBCCCDDD
- กรณีร้านค้าต้องการส่งค่า Settled จะมีเงื่อนไขดังนี้
- – หากเป็น True ให้กำหนดค่าตอนหา Checksum เป็น “True”
- – หากเป็น False ให้กำหนดค่าตอนหา Checksum เป็น “False”
ตารางที่ 2.3 Response Message Parameters
No. | Parameters Name | Data Type | Description |
---|---|---|---|
1 | totalRecord | Number | จำนวนรายการทั้งหมด |
2 | pageSize | Number | จำนวนรายการต่อหน้า |
3 | pageNumber | Number | เลขหน้า |
4 | filteredRecord | Number | จำนวนรายการในหน้าปัจจุบัน |
5 | status | String | รหัสสถานะการทำรายการ ภาคผนวก ค. |
6 | message | String | คำอธิบายสถานะการทำรายการ |
7 | data[].transactionId | Number | เลขที่อ้างอิงรายการของทางชิวเพย์ |
8 | data[].transactionDate | String | วันที่ทำรายการ [dd/MM/yyyy HH:mm:ss] |
9 | data[].paymentDate | String | วันที่ชำระเงิน [dd/MM/yyyy HH:mm:ss] |
10 | data[].merchant | String | ชื่อร้านค้า |
11 | data[].customer | String | รหัสอ้างอิงหรือชื่อลูกค้า |
12 | data[].orderNo | String | เลขที่อ้างอิงรายการของทางร้านค้า |
13 | data[].paymentChannel | String | ช่องทางการชำระเงิน |
14 | data[].routeNo | Number | เส้นทางชำระเงิน |
15 | data[].amount | String | ค่าสินค้าหรือบริการ [#,##0.00] |
16 | data[].fee | String | ค่าธรรมเนียม [#,##0.00] |
17 | data[].totalAmount | String | ราคารวม [#,##0.00] |
18 | data[].currency | String | สกุลเงิน |
19 | data[].exchangeRate | String | อัตราแลกเปลี่ยน [#,##0.00] |
20 | data[].discount | String | ส่วนลด [#,##0.00] |
21 | data[].netAmount | String | ราคาสุทธิ [#,##0.00] |
22 | data[].serviceAmount | String | ค่าบริการ [#,##0.00] |
23 | data[].serviceVAT | String | ภาษีค่าบริการ [#,##0.00] |
24 | data[].serviceWHT | String | ภาษีหัก ณ ที่จ่าย [#,##0.00] |
25 | data[].settleAmount | String | ยอดเงินโอนให้ร้านค้า [#,##0.00] |
26 | data[].settled | Boolean | สถานะการโอนเงินให้ร้านค้า [True, False] |
ตัวอย่าง ข้อมูล JSON Response Message ที่ได้รับจากการเรียก API
{
"totalRecord": 106,
"pageSize": 10,
"pageNumber": 1,
"filteredRecord": 10,
"status": 200,
"message": "Success",
"data": [
{
"transactionId": 114705,
"transactionDate": "17/01/2022 15:00:46",
"paymentDate": "17/01/2022 15:01:44",
"merchant": "Bank Industries",
"customer": "cus100005",
"orderNo": "order20211216101345",
"paymentChannel": "Credit Card",
"routeNo": 3,
"amount": "3,500.00",
"fee": "15.00",
"totalAmount": "3,515.00",
"currency": "THB",
"exchangeRate": "1.00",
"discount": "0.00",
"netAmount": "3,515.00",
"serviceAmount": "113.75",
"serviceVAT": "7.96",
"serviceWHT": "3.41",
"settleAmount": "3,381.70",
"settled": false
},
...
]
}
Search Void Transaction
Service Name: | Search Void Transaction |
URL: | [SANDBOX] https://sandbox-api-transaction.chillpay.co/api/v1/void/search |
[PROD] https://api-transaction.chillpay.co/api/v1/void/search | |
Method: | POST |
Description: | เป็นเซอร์วิสในการค้นหารายการยกเลิก (Void Transactions) – ร้านค้าหลักสามารถค้นหาข้อมูลของร้านค้าย่อยได้ – ร้านค้าย่อยสามารถค้นหาได้เฉพาะร้านค้าตนเองเท่านั้น |
ตารางที่ 3.1 Request Header Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | Content-Type | String | 16 | M | application/json |
2 | CHILLPAY-MerchantCode | String | 15 | M | รหัสร้านค้าที่ออกให้โดยชิวเพย์ |
3 | CHILLPAY-ApiKey | String | 100 | M | รหัสอ้างอิงที่ออกให้โดยชิวเพย์ ใช้ในการเชื่อมต่อระบบ |
ตารางที่ 3.2 Request Body Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | OrderBy | String | 20 | O | เรียงตามคอลัมน์- TransactionId- TransactionDate- Merchant- Customer- OrderNo- PaymentChannel- PaymentDate- Amount- Fee- TotalAmount- RouteNo- Status* หากไม่ได้ส่งมาค่าเริ่มต้นคือ TransactionId |
2 | OrderDir | String | 4 | O | การเรียงลำดับASC : เรียงจากน้อยไปมาก DESC : เรียงจากมากไปน้อย * หากไม่ได้ส่งมาค่าเริ่มต้นคือ DESC |
3 | PageSize | Number | O | จำนวนรายการต่อหน้า (1-100) * หากไม่ได้ส่งมาค่าเริ่มต้นคือ 10 | |
4 | PageNumber | Number | O | เลขหน้า * หากไม่ได้ส่งมาค่าเริ่มต้นคือ 1 | |
5 | SearchKeyword | String | 255 | O | คำหรือข้อความที่ต้องการค้นหา |
6 | MerchantCode | String | 15 | O | รหัสร้านค้าที่ต้องการค้นหา |
7 | OrderNo | String | 20 | O | เลขที่อ้างอิงรายการของทางร้านค้า |
8 | Status | String | 20 | O | สถานะการชำระเงิน ภาคผนวก ก. |
9 | TransactionDateFrom | String | 19 | O | วันที่ทำรายการ (จาก) [dd/MM/yyyy HH:mm:ss] |
10 | TransactionDateTo | String | 19 | O | วันที่ทำรายการ (ถึง) [dd/MM/yyyy HH:mm:ss] |
11 | Checksum | String | 32 | M | ผลลัพธ์ที่ได้จากการนำค่าทั้งหมดไปเข้ารหัส |
ตัวอย่าง การเรียก Request Search Void Transaction (Code ภาษา C# .NET)
var client = new RestClient("https://api-transaction.chillpay.co/api/v1/void/search");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("CHILLPAY-MerchantCode", "xxx");
request.AddHeader("CHILLPAY-ApiKey", "xxx");
request.AddHeader("Content-Type", "application/json");
var body = @"{""OrderBy"": ""TransactionId"", ""OrderDir"": ""DESC"", ""PageSize"": null, ""PageNumber"": null, ""SearchKeyword"": null, ""MerchantCode"": null, ""OrderNo"": null, ""Status"": null, ""TransactionDateFrom"": null, ""TransactionDateTo"": null, ""Checksum"": ""380eb9dff5f97b1c705030ee922959e6""}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
หมายเหตุ
- ค่า Checksum เป็นการนำค่าจาก Parameter ตามตารางที่ 3.2 (ข้อ 1-10) มาเรียงต่อกัน แล้วต่อท้ายด้วย MD5 Secret Key (ที่ได้รับจากทางชิวเพย์) ดังนี้
- OrderBy + OrderDir + PageSize + PageNumber + SearchKeyword + MerchantCode + OrderNo + Status + TransactionDateFrom + TransactionDateTo + MD5 Secret Key
- จากนั้นนำข้อมูลที่เรียงกันทั้งหมดนี้ไปเข้ารหัสด้วยฟังก์ชั่น MD5 Hashing จึงจะได้เป็นค่า Checksum
- ตัวอย่าง การนำข้อมูลมาเรียงต่อกันเพื่อเข้าฟังก์ชั่น MD5
- TransactionIdDESCAAABBBCCCDDD
ตารางที่ 3.3 Response Message Parameters
No. | Parameters Name | Data Type | Description |
---|---|---|---|
1 | totalRecord | Number | จำนวนรายการทั้งหมด |
2 | pageSize | Number | จำนวนรายการต่อหน้า |
3 | pageNumber | Number | เลขหน้า |
4 | filteredRecord | Number | จำนวนรายการในหน้าปัจจุบัน |
5 | status | String | รหัสสถานะการทำรายการ ภาคผนวก ค. |
6 | message | String | คำอธิบายสถานะการทำรายการ |
7 | data[].transactionId | Number | เลขที่อ้างอิงรายการของทางชิวเพย์ |
8 | data[].transactionDate | String | วันที่ทำรายการ [dd/MM/yyyy HH:mm:ss] |
9 | data[].merchant | String | ชื่อร้านค้า |
10 | data[].customer | String | รหัสอ้างอิงหรือชื่อลูกค้า |
11 | data[].orderNo | String | เลขที่อ้างอิงรายการของทางร้านค้า |
12 | data[].paymentChannel | String | ช่องทางการชำระเงิน |
13 | data[].paymentDate | String | วันที่ชำระเงิน [dd/MM/yyyy HH:mm:ss] |
14 | data[].amount | String | ค่าสินค้าหรือบริการ [#,##0.00] |
15 | data[].fee | String | ค่าธรรมเนียม [#,##0.00] |
16 | data[].totalAmount | String | ราคารวม [#,##0.00] |
17 | data[].currency | String | สกุลเงิน |
18 | data[].routeNo | Number | เส้นทางชำระเงิน |
19 | data[].serviceFee | String | ค่าบริการ [#,##0.00] |
20 | data[].status | String | สถานะการชำระเงิน |
ตัวอย่าง ข้อมูล JSON Response Message ที่ได้รับจากการเรียก API
{
"totalRecord": 1,
"pageSize": 10,
"pageNumber": 1,
"filteredRecord": 1,
"status": 200,
"message": "Success",
"data": [
{
"transactionId": 115006,
"transactionDate": "03/02/2022 11:50:39",
"merchant": "Bank Industries",
"customer": "cus100005",
"orderNo": "order20211216101345",
"paymentChannel": "Credit Card",
"paymentDate": "04/03/2022 16:10:31",
"amount": "3,500.00",
"fee": "15.00",
"totalAmount": "3,515.00",
"currency": "THB",
"routeNo": 3,
"serviceFee": "0.00",
"status": "Void Requested"
}
]
}
Search Refund Transaction
Service Name: | Search Refund Transaction |
URL: | [SANDBOX] https://sandbox-api-transaction.chillpay.co/api/v1/refund/search |
[PROD] https://api-transaction.chillpay.co/api/v1/refund/search | |
Method: | POST |
Description: | เป็นเซอร์วิสในการค้นหารายการขอคืนเงิน (Refund Transactions)- ร้านค้าหลักสามารถค้นหาข้อมูลของร้านค้าย่อยได้- ร้านค้าย่อยสามารถค้นหาได้เฉพาะร้านค้าตนเองเท่านั้น |
ตารางที่ 4.1 Request Header Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | Content-Type | String | 16 | M | application/json |
2 | CHILLPAY-MerchantCode | String | 15 | M | รหัสร้านค้าที่ออกให้โดยชิวเพย์ |
3 | CHILLPAY-ApiKey | String | 100 | M | รหัสอ้างอิงที่ออกให้โดยชิวเพย์ ใช้ในการเชื่อมต่อระบบ |
ตารางที่ 4.2 Request Body Parameters
No. | Parameters Name | Data Type | Data Type | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | OrderBy | String | 20 | O | เรียงตามคอลัมน์- TransactionId- TransactionDate- Merchant- Customer- OrderNo- PaymentChannel- PaymentDate- Amount- Fee- TotalAmount- RouteNo- Status* หากไม่ได้ส่งมาค่าเริ่มต้นคือ TransactionId |
2 | OrderDir | String | 4 | O | การเรียงลำดับASC : เรียงจากน้อยไปมากDESC : เรียงจากมากไปน้อย* หากไม่ได้ส่งมาค่าเริ่มต้นคือ DESC |
3 | PageSize | Number | O | จำนวนรายการต่อหน้า (1-100)* หากไม่ได้ส่งมาค่าเริ่มต้นคือ 10 | |
4 | PageNumber | Number | O | เลขหน้า* หากไม่ได้ส่งมาค่าเริ่มต้นคือ 1 | |
5 | SearchKeyword | String | 255 | O | คำหรือข้อความที่ต้องการค้นหา |
6 | MerchantCode | String | 15 | O | รหัสร้านค้าที่ต้องการค้นหา |
7 | OrderNo | String | 20 | O | เลขที่อ้างอิงรายการของทางร้านค้า |
8 | Status | String | 20 | O | สถานะการชำระเงิน ภาคผนวก ก. |
9 | TransactionDateFrom | String | 19 | O | วันที่ทำรายการ (จาก) [dd/MM/yyyy HH:mm:ss] |
10 | TransactionDateTo | String | 19 | O | วันที่ทำรายการ (ถึง) [dd/MM/yyyy HH:mm:ss] |
11 | Checksum | String | 32 | M | ผลลัพธ์ที่ได้จากการนำค่าทั้งหมดไปเข้ารหัส |
ตัวอย่าง การเรียก Request Search Refund Transaction (Code ภาษา C# .NET)
var client = new RestClient("https://api-transaction.chillpay.co/api/v1/refund/search");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("CHILLPAY-MerchantCode", "xxx");
request.AddHeader("CHILLPAY-ApiKey", "xxx");
request.AddHeader("Content-Type", "application/json");
var body = @"{""OrderBy"": ""TransactionId"", ""OrderDir"": ""DESC"", ""PageSize"": null, ""PageNumber"": null, ""SearchKeyword"": null, ""MerchantCode"": null, ""OrderNo"": null, ""Status"": null, ""TransactionDateFrom"": null, ""TransactionDateTo"": null, ""Checksum"": ""3ca662ef331497e7cce6b00dc3f783c1""}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
หมายเหตุ
- ค่า Checksum เป็นการนำค่าจาก Parameter ต่าง ๆ ตามตารางที่ 4.2 (ข้อ 1 –10) มาเรียงต่อกัน แล้วต่อท้ายด้วย MD5 Secret Key (ที่ได้รับจากทางชิวเพย์) ดังนี้
- OrderBy + OrderDir + PageSize + PageNumber + SearchKeyword + MerchantCode + OrderNo + Status + TransactionDateFrom + TransactionDateTo + MD5 Secret Key
- จากนั้นนำข้อมูลที่เรียงกันทั้งหมดนี้ไปเข้ารหัสด้วยฟังก์ชั่น MD5 Hashing จึงจะได้เป็นค่า Checksum
- ตัวอย่าง การนำข้อมูลมาเรียงต่อกันเพื่อเข้าฟังก์ชั่น MD5
- TransactionIdDESCAAABBBCCCDDD
ตารางที่ 4.3 Response Message Parameters
No. | Parameters Name | Data Type | Description |
---|---|---|---|
1 | totalRecord | Number | จำนวนรายการทั้งหมด |
2 | pageSize | Number | จำนวนรายการต่อหน้า |
3 | pageNumber | Number | เลขหน้า |
4 | filteredRecord | Number | จำนวนรายการในหน้าปัจจุบัน |
5 | status | String | รหัสสถานะการทำรายการ ภาคผนวก ค. |
6 | message | String | คำอธิบายสถานะการทำรายการ |
7 | data[].transactionId | Number | เลขที่อ้างอิงรายการของทางชิวเพย์ |
8 | data[].transactionDate | String | วันที่ทำรายการ [dd/MM/yyyy HH:mm:ss] |
9 | data[].merchant | String | ชื่อร้านค้า |
10 | data[].customer | String | รหัสอ้างอิงหรือชื่อลูกค้า |
11 | data[].orderNo | String | เลขที่อ้างอิงรายการของทางร้านค้า |
12 | data[].paymentChannel | String | ช่องทางการชำระเงิน |
13 | data[].paymentDate | String | วันที่ชำระเงิน [dd/MM/yyyy HH:mm:ss] |
14 | data[].amount | String | ค่าสินค้าหรือบริการ [#,##0.00] |
15 | data[].fee | String | ค่าธรรมเนียม [#,##0.00] |
16 | data[].totalAmount | String | ราคารวม [#,##0.00] |
17 | data[].currency | String | สกุลเงิน |
18 | data[].routeNo | Number | เส้นทางชำระเงิน |
19 | data[].serviceFee | String | ค่าบริการ [#,##0.00] |
20 | data[].status | String | สถานะการชำระเงิน |
ตัวอย่าง ข้อมูล JSON Response Message ที่ได้รับจากการเรียก API
{
"totalRecord": 6,
"pageSize": 10,
"pageNumber": 1,
"filteredRecord": 6,
"status": 200,
"message": "Success",
"data": [
{
"transactionId": 41613,
"transactionDate": "24/09/2020 19:58:01",
"merchant": "Bank Industries",
"customer": "TEST",
"orderNo": "21",
"paymentChannel": "Credit Card",
"paymentDate": "24/09/2020 19:58:55",
"amount": "20,000.00",
"fee": "650.00",
"totalAmount": "20,650.00",
"currency": "THB",
"routeNo": 1,
"serviceFee": "650.00",
"status": "Refund Requested"
},
...
]
}
Get Payment Transaction Details
Service Name: | Get Payment Transaction Details |
URL: | [SANDBOX] https://sandbox-api-transaction.chillpay.co/api/v1/payment/details |
[PROD] https://api-transaction.chillpay.co/api/v1/payment/details | |
Method: | POST |
Description: | เป็นเซอร์วิสในการเรียกดูรายละเอียดรายการชำระเงิน (Payment Transaction) – ร้านค้าหลักสามารถดูข้อมูลของร้านค้าย่อยได้ – ร้านค้าย่อยสามารถค้นหาได้เฉพาะร้านค้าตนเองเท่านั้น |
ตารางที่ 5.1 Request Header Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | Content-Type | String | 16 | M | application/json |
2 | CHILLPAY-MerchantCode | String | 15 | M | รหัสร้านค้าที่ออกให้โดยชิวเพย์ |
3 | CHILLPAY-ApiKey | String | 100 | M | รหัสอ้างอิงที่ออกให้โดยชิวเพย์ ใช้ในการเชื่อมต่อระบบ |
ตารางที่ 5.2 Request Body Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | TransactionId | Number | M | เลขที่อ้างอิงรายการของทางชิวเพย์ | |
2 | Checksum | String | 32 | M | ผลลัพธ์ที่ได้จากการนำค่าทั้งหมดไปเข้ารหัส |
ตัวอย่าง การเรียก Request Get Payment Transaction Details (Code ภาษา C# .NET)
var client = new RestClient("https://api-transaction.chillpay.co/api/v1/payment/details");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("CHILLPAY-MerchantCode", "xxx");
request.AddHeader("CHILLPAY-ApiKey", "xxx");
request.AddHeader("Content-Type", "application/json");
var body = @"{""TransactionId"": 115006, ""Checksum"": ""75db12ab69411c40e74ff40ae09fcca8""}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
หมายเหตุ
- ค่า Checksum เป็นการนำค่าจาก Parameter ตามตารางที่ 5.2 (ข้อ 1) มาต่อท้ายด้วย MD5 Secret Key (ที่ได้รับจากทางชิวเพย์) ดังนี้
- TransactionId + MD5 Secret Key
- จากนั้นนำข้อมูลที่เรียงกันทั้งหมดนี้ไปเข้ารหัสด้วยฟังก์ชั่น MD5 Hashing จึงจะได้เป็นค่า Checksum
- ตัวอย่าง การนำข้อมูลมาเรียงต่อกันเพื่อเข้าฟังก์ชั่น MD5
- 115006AAABBBCCCDDD
ตารางที่ 5.3 Response Message Parameters
No. | Parameters Name | Data Type | Description |
---|---|---|---|
1 | status | String | รหัสสถานะการทำรายการ ภาคผนวก ค. |
2 | message | String | คำอธิบายสถานะการทำรายการ |
3 | data[].transactionId | Number | เลขที่อ้างอิงรายการของทางชิวเพย์ |
4 | data[].merchant | String | ชื่อร้านค้า |
5 | data[].paymentChannel | String | ช่องทางการชำระเงิน |
6 | data[].amount | String | ค่าสินค้าหรือบริการ [#,##0.00] |
7 | data[].fee | String | ค่าธรรมเนียม [#,##0.00] |
8 | data[].discount | String | ส่วนลด [#,##0.00] |
9 | data[].totalAmount | String | ราคารวม [#,##0.00] |
10 | data[].orderNo | String | เลขที่อ้างอิงรายการของทางร้านค้า |
11 | data[].customer | String | รหัสอ้างอิงหรือชื่อลูกค้า |
12 | data[].phoneNumber | String | เบอร์โทรศัพท์มือถือของลูกค้า |
13 | data[].languageCode | String | รหัสภาษา |
14 | data[].status | String | สถานะการชำระเงิน |
15 | data[].currency | String | สกุลเงิน |
16 | data[].ipAddress | String | ข้อมูลไอพีของลูกค้า |
17 | data[].merchantResponseCode | String | รหัสตอบกลับจากทางร้านค้า |
18 | data[].merchantResponseMessage | String | ข้อความตอบกลับจากทางร้านค้า |
19 | data[].paymentDate | String | วันที่ชำระเงิน [dd/MM/yyyy HH:mm:ss] |
20 | data[].transactionDate | String | วันที่ทำรายการ [dd/MM/yyyy HH:mm:ss] |
21 | data[].description | String | รายละเอียดการชำระเงิน |
22 | data[].settled | Boolean | สถานะการโอนเงินให้ร้านค้า [True, False] |
ตัวอย่าง ข้อมูล JSON Response Message ที่ได้รับจากการเรียก API
{
"status": 200,
"message": "Success",
"data": {
"transactionId": 115006,
"merchant": "Bank Industries",
"paymentChannel": "Credit Card",
"amount": "3,500.00",
"fee": "15.00",
"discount": "0.00",
"totalAmount": "3,515.00",
"orderNo": "order20211216101345",
"customer": "cus100005",
"phoneNumber": "0822318917",
"languageCode": "TH",
"status": "Void Requested",
"currency": "THB",
"ipAddress": "171.103.196.214",
"merchantResponseCode": "200",
"merchantResponseMessage": "Send data to merchant completed",
"paymentDate": "04/03/2022 16:10:31",
"transactionDate": "03/02/2022 11:50:39",
"description": " ",
"settled": false
}
}
Request Void Transaction
Service Name: | Request Void Transaction |
URL: | [SANDBOX] https://sandbox-api-transaction.chillpay.co/api/v1/void/request |
[PROD] https://api-transaction.chillpay.co/api/v1/void/request | |
Method: | POST |
Description: | เป็นเซอร์วิสสำหรับร้องขอยกเลิกรายการชำระเงิน กรณีที่รายการนั้นยังไม่ Settled – ร้านค้าหลักสามารถร้องขอยกเลิกรายการชำระเงินของร้านค้าย่อยได้ – ร้านค้าย่อยสามารถร้องขอยกเลิกรายการชำระเงินได้เฉพาะร้านค้าตนเองเท่านั้น |
ตารางที่ 6.1 Request Header Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | Content-Type | String | 16 | M | application/json |
2 | CHILLPAY-MerchantCode | String | 15 | M | รหัสร้านค้าที่ออกให้โดยชิวเพย์ |
3 | CHILLPAY-ApiKey | String | 100 | M | รหัสอ้างอิงที่ออกให้โดยชิวเพย์ ใช้ในการเชื่อมต่อระบบ |
ตารางที่ 6.2 Request Body Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | TransactionId | Number | M | เลขที่อ้างอิงรายการของทางชิวเพย์ | |
2 | Checksum | String | 32 | M | ผลลัพธ์ที่ได้จากการนำค่าทั้งหมดไปเข้ารหัส |
ตัวอย่าง การเรียก Request Request Void Transaction (Code ภาษา C# .NET)
var client = new RestClient("https://api-transaction.chillpay.co/api/v1/void/request");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("CHILLPAY-MerchantCode", "xxx");
request.AddHeader("CHILLPAY-ApiKey", "xxx");
request.AddHeader("Content-Type", "application/json");
var body = @"{""TransactionId"": 115006, ""Checksum"": ""75db12ab69411c40e74ff40ae09fcca8""}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
หมายเหตุ
- ค่า Checksum เป็นการนำค่าจาก Parameter ต่าง ๆ ตามตารางที่ 6.2 (ข้อ 1) มาเรียงต่อกัน แล้วต่อท้ายด้วย MD5 Secret Key (ที่ได้รับจากทางชิวเพย์) ดังนี้
- TransactionId + MD5 Secret Key
- จากนั้นนำข้อมูลที่เรียงกันทั้งหมดนี้ไปเข้ารหัสด้วยฟังก์ชั่น MD5 Hashing จึงจะได้เป็นค่า Checksum
- ตัวอย่าง การนำข้อมูลมาเรียงต่อกันเพื่อเข้าฟังก์ชั่น MD5
- 115006AAABBBCCCDDD
ตารางที่ 6.3 Response Message Parameters
No. | Parameters Name | Data Type | Description |
---|---|---|---|
1 | status | String | รหัสสถานะการทำรายการ ภาคผนวก ค. |
2 | message | String | คำอธิบายสถานะการทำรายการ |
3 | data.transactionId | Number | เลขที่อ้างอิงรายการของทางชิวเพย์ |
4 | data.transactionDate | String | วันที่ทำรายการ [dd/MM/yyyy HH:mm:ss] |
5 | data.merchant | String | ชื่อร้านค้า |
6 | data.customer | String | รหัสอ้างอิงหรือชื่อลูกค้า |
7 | data.orderNo | String | เลขที่อ้างอิงรายการของทางร้านค้า |
8 | data.paymentChannel | String | ช่องทางการชำระเงิน |
9 | data.paymentDate | String | วันที่ชำระเงิน [dd/MM/yyyy HH:mm:ss] |
10 | data.amount | String | ค่าสินค้าหรือบริการ [#,##0.00] |
11 | data.fee | String | ค่าธรรมเนียม [#,##0.00] |
12 | data.totalAmount | String | ราคารวม [#,##0.00] |
13 | data.currency | String | สกุลเงิน |
14 | data.routeNo | Number | เส้นทางชำระเงิน |
15 | data.serviceFee | String | ค่าบริการ [#,##0.00] |
16 | data.status | String | สถานะการชำระเงิน |
ตัวอย่าง ข้อมูล JSON Response Message ที่ได้รับจากการเรียก API
{
"status": 200,
"message": "Success",
"data": {
"transactionId": 115006,
"transactionDate": "03/02/2022 11:50:39",
"merchant": "Bank Industries",
"customer": "cus100005",
"orderNo": "order20211216101345",
"paymentChannel": "Credit Card",
"paymentDate": "10/03/2022 12:22:54",
"amount": "3,500.00",
"fee": "15.00",
"totalAmount": "3,515.00",
"currency": "THB",
"routeNo": 3,
"serviceFee": "0.00",
"status": "Void Requested"
}
}
Request Refund Transaction
Service Name: | Request Refund Transaction |
URL: | [SANDBOX] https://sandbox-api-transaction.chillpay.co/api/v1/refund/request |
[PROD] https://api-transaction.chillpay.co/api/v1/refund/request | |
Method: | POST |
Description: | เป็นเซอร์วิสสำหรับร้องขอการคืนเงิน กรณีที่รายการนั้นถูก Settled แล้ว – ร้านค้าหลักสามารถร้องขอยกเลิกรายการชำระเงินของร้านค้าย่อยได้ – ร้านค้าย่อยสามารถร้องขอยกเลิกรายการชำระเงินได้เฉพาะร้านค้าตนเองเท่านั้น |
ตารางที่ 7.1 Request Header Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | Content-Type | String | 16 | M | application/json |
2 | CHILLPAY-MerchantCode | String | 15 | M | รหัสร้านค้าที่ออกให้โดยชิวเพย์ |
3 | CHILLPAY-ApiKey | String | 100 | M | รหัสอ้างอิงที่ออกให้โดยชิวเพย์ ใช้ในการเชื่อมต่อระบบ |
ตารางที่ 7.2 Request Body Parameters
No. | Parameters Name | Data Type | Length | Mandatory / Optional | Description |
---|---|---|---|---|---|
1 | TransactionId | Number | M | เลขที่อ้างอิงรายการของทางชิวเพย์ | |
2 | Checksum | String | 32 | M | ผลลัพธ์ที่ได้จากการนำค่าทั้งหมดไปเข้ารหัส |
ตัวอย่าง การเรียก Request Request Refund Transaction (Code ภาษา C# .NET)
var client = new RestClient("https://sandbox-api-transaction.chillpay.co/api/v1/refund/request");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("CHILLPAY-MerchantCode", "xxx");
request.AddHeader("CHILLPAY-ApiKey", "xxx");
request.AddHeader("Content-Type", "application/json");
var body = @"{""TransactionId"": 115007, ""Checksum"": ""75db12ab69411c40e74ff40ae09fcca8""}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
หมายเหตุ
- ค่า Checksum เป็นการนำค่าจาก Parameter ตามตารางที่ 7.2 (ข้อ 1) มาต่อท้ายด้วย MD5 Secret Key (ที่ได้รับจากทางชิวเพย์) ดังนี้
- TransactionId + MD5 Secret Key
- จากนั้นนำข้อมูลที่เรียงกันทั้งหมดนี้ไปเข้ารหัสด้วยฟังก์ชั่น MD5 Hashing จึงจะได้เป็นค่า Checksum
- ตัวอย่าง การนำข้อมูลมาเรียงต่อกันเพื่อเข้าฟังก์ชั่น MD5
- 115007AAABBBCCCDDD
ตารางที่ 7.3 Response Message Parameters
No. | Parameters Name | Data Type | Description |
---|---|---|---|
1 | status | String | รหัสสถานะการทำรายการ ภาคผนวก ค. |
2 | message | String | คำอธิบายสถานะการทำรายการ |
3 | data.transactionId | Number | เลขที่อ้างอิงรายการของทางชิวเพย์ |
4 | data.transactionDate | String | วันที่ทำรายการ [dd/MM/yyyy HH:mm:ss] |
5 | data.merchant | String | ชื่อร้านค้า |
6 | data.customer | String | รหัสอ้างอิงหรือชื่อลูกค้า |
7 | data.orderNo | String | เลขที่อ้างอิงรายการของทางร้านค้า |
8 | data.paymentChannel | String | ช่องทางการชำระเงิน |
9 | data.paymentDate | String | วันที่ชำระเงิน [dd/MM/yyyy HH:mm:ss] |
10 | data.amount | String | ค่าสินค้าหรือบริการ [#,##0.00] |
11 | data.fee | String | ค่าธรรมเนียม [#,##0.00] |
12 | data.totalAmount | String | ราคารวม [#,##0.00] |
13 | data.currency | String | สกุลเงิน |
14 | data.routeNo | Number | เส้นทางชำระเงิน |
15 | data.serviceFee | String | ค่าบริการ [#,##0.00] |
16 | data.status | String | สถานะการชำระเงิน |
ตัวอย่าง ข้อมูล JSON Response Message ที่ได้รับจากการเรียก API
{
"status": 200,
"message": "Success",
"data": {
"transactionId": 115007,
"transactionDate": "03/02/2022 11:50:39",
"merchant": "Bank Industries",
"customer": "cus100005",
"orderNo": "order20211216101345",
"paymentChannel": "Credit Card",
"paymentDate": "04/03/2022 16:10:31",
"amount": "3,500.00",
"fee": "15.00",
"totalAmount": "3,515.00",
"currency": "THB",
"routeNo": 3,
"serviceFee": "113.75",
"status": "Refund Requested"
}
}
ภาคผนวก
ภาคผนวก ก. Payment Transaction Status
No. | Text | Description |
---|---|---|
1 | Success | ทำรายการชำระเงินสำเร็จ |
2 | Fail | ทำรายการชำระเงินไม่สำเร็จ |
3 | Cancel | ลูกค้ายกเลิกการชำระเงิน |
4 | Error | เกิดข้อผิดพลาดระหว่างทำรายการชำระเงิน |
5 | Request | รอการชำระค่าสินค้า/บริการ |
6 | Void Requested | ทำรายการร้องขอการยกเลิกรายการสำเร็จ |
7 | Voided | ทำรายการยกเลิกรายการสำเร็จ |
8 | Refund Requested | ทำรายการร้องขอการคืนเงินสำเร็จ |
9 | Refunded | ทำรายการคืนเงินสำเร็จ |
ภาคผนวก ข. Payment Channel
No. | Text | Description |
---|---|---|
1 | CREDIT CARD | บัตรเครดิตและเดบิต |
2 | INSTALLMENT KBANK | ผ่อนชำระบัตรธนาคารกสิกร |
3 | KTC FLEXI | ผ่อนชำระบัตรกรุงไทย |
4 | INSTALLMENT KRUNGSRI | ผ่อนชำระบัตรในเครือธนาคารกรุงศรีฯ |
5 | INSTALLMENT SCB | ผ่อนชำระบัตรธนาคารไทยพาณิชย์ |
6 | FIRST CHOICE | ผ่อนชำระบัตรกรุงศรีเฟิร์สช้อยส์ |
7 | KTC FOREVER | แลกคะแนนบัตรกรุงไทย |
8 | BAY | ธนาคารกรุงศรีอยุธยา |
9 | BBL | ธนาคารกรุงเทพ |
10 | SCB | ธนาคารไทยพาณิชย์ |
11 | KTB | ธนาคารกรุงไทย |
12 | TBANK | ธนาคารธนชาต |
13 | TTB | ธนาคารทหารไทยธนชาต |
14 | KPLUS | ธนาคารกสิกร (K PLUS) |
15 | SCB EASY APP | ธนาคารไทยพาณิชย์ (SCB Easy App) |
16 | KMA APP | ธนาคารกรุงศรีอยุธยา (KMA App) |
17 | QRCODE | คิวอาร์ พร้อมเพย์ |
18 | ALIPAY | อาลีเพย์ |
19 | WECHATPAY | วีแชทเพย์ |
20 | LINEPAY | แรบบิท ไลน์ เพย์ |
21 | TRUEMONEY | ทรูมันนี่ วอลเล็ท |
22 | SHOPEEPAY | ช้อปปี้เพย์ |
23 | CENPAY | เซ็นเพย์ |
24 | BIGC | บิ๊กซี |
25 | BOONTERM | บุญเติม |
ภาคผนวก ค. Response Message
Code | Status Message | Description |
---|---|---|
200 | Success | ทำรายการสำเร็จ |
1001 | InvalidParameter | พารามิเตอร์ไม่ถูกต้อง |
1002 | InvalidMerchantCode | รหัสร้านค้าไม่ถูกต้อง |
1003 | InvalidApiKey | รหัสอ้างอิงร้านค้าไม่ถูกต้อง |
1004 | InvalidChecksum | รหัส Checksum ไม่ถูกต้อง |
2001 | InvalidMerchantCodeData | ข้อมูลรหัสร้านค้าไม่ถูกต้อง |
2002 | InvalidApiKeyData | ข้อมูลรหัสอ้างอิงร้านค้าไม่ถูกต้อง |
2003 | InvalidOrderByData | ข้อมูลสำหรับเรียงตามคอลัมน์ไม่ถูกต้อง |
2004 | InvalidOrderDirData | ข้อมูลสำหรับทิศทางการเรียงไม่ถูกต้อง |
2005 | InvalidPageSizeData | ข้อมูลจำนวนรายการต่อหน้าไม่ถูกต้อง |
2006 | InvalidPageNumberData | ข้อมูลเลขหน้าไม่ถูกต้อง |
2007 | InvalidSearchKeywordData | ข้อมูลคำหรือข้อความที่ต้องการค้นหาไม่ถูกต้อง |
2008 | InvalidPaymentChannelData | ข้อมูลช่องทางการชำระเงินไม่ถูกต้อง |
2009 | InvalidOrderNoData | ข้อมูลเลขที่อ้างอิงรายการของทางร้านค้าไม่ถูกต้อง |
2010 | InvalidStatusData | ข้อมูลสถานะการชำระเงินไม่ถูกต้อง |
2011 | InvalidTransactionDateData | ข้อมูลวันที่ทำรายการไม่ถูกต้อง |
2012 | InvalidPaymentDateData | ข้อมูลวันที่ชำระเงินไม่ถูกต้อง |
2013 | InvalidTransactionIdData | ข้อมูลเลขที่อ้างอิงรายการไม่ถูกต้อง |
2014 | InvalidChecksumData | ข้อมูลรหัส Checksum ไม่ถูกต้อง |
3001 | SearchFailed | การค้นหาล้มเหลว |
3002 | TransactionNotFound | ไม่เจอรายการชำระเงิน |
3003 | VoidFailed | ไม่สามารถทำการยกเลิกรายการได้ |
3004 | RefundFailed | ไม่สามารถทำรายการขอคืนเงินได้ |
4001 | AccountUnauthorized | บัญชีร้านค้ายังไม่ได้รับการอนุมัติ |
4002 | SystemError | ระบบเกิดข้อผิดพลาดไม่สามารถทำรายการได้ |
4003 | SystemMaintenanceTime | อยู่ในระยะเวลาปรับปรุงระบบ |
4004 | RequestExceededLimit | การร้องขอเกินจำนวนที่กำหนด |