POS API Documentation

Version : 2.0.1

Authentication & Profile

Login ขอโทเคนสำหรับการใช้งาน

POST https://topupapi.renny.co.th/topup/pos/v1/login HTTP/1.1
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/login

username และ password ขอได้จากผู้ดูแลระบบหลังจากทำการเปิดระบบเรียบร้อยแล้ว

Request Body

Name Type M/O Description
username string M ชื่อผู้ใช้
password string M รหัสผ่าน

ตัวอย่าง response body

Response Body

Name Type Description
status object สถานะ
data object ข้อมูล
token string token สำหรับใช้งานระบบ

Change Password เปลี่ยนรหัสผ่านการเข้าสู่ระบบ

POST https://topupapi.renny.co.th/topup/pos/v1/changePassword HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/changePassword

Request Body

Name Type M/O Description
oldPassword string M รหัสผ่านปัจุบัน
newPassword string M รหัสผ่านที่ต้องการเปลี่ยน

ตัวอย่าง response body

Response Body

Name Type Description
status object สถานะ

Get Profile เปลี่ยนรหัสผ่านการเข้าสู่ระบบ

POST https://topupapi.renny.co.th/topup/pos/v1/getProfile HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/getProfile

Request Body

No request body

No request body

ตัวอย่าง response body

Response Body

Name Type Description
status object สถานะ
data object ข้อมูล
partnerId string รหัสหุ้นส่วน
memberId string รหัสสมาชิก
firstname string ชื่อสมาชิก
phoneNo string เบอร์โทรศัพท์สมาชิก
credit string เครดิตคงเหลือ
status string สถานะของสมาชิก

Topup Service

Prepaid Verify ตรวจสอบข้อมูลการเติม prepaid

POST https://topupapi.renny.co.th/topup/pos/v1/verifyTopupMobile/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/verifyTopupMobile/{customerMobile}

รายการ prepaid ที่ทำรายการได้

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

Prepaid Confirm ยืนยันการเติม prepaid

POST https://topupapi.renny.co.th/topup/pos/v1/confirmTopupMobile/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/confirmTopupMobile/{customerMobile}

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

E-Wallet Verify ตรวจสอบข้อมูลการเติม wallet

POST https://topupapi.renny.co.th/topup/pos/v1/verifyTopupWallet/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/verifyTopupWallet/{customerMobile}

รายการ wallet ที่ทำรายการได้

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

E-Wallet Confirm ยืนยันการเติม wallet

POST https://topupapi.renny.co.th/topup/pos/v1/confirmTopupWallet/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/confirmTopupWallet/{customerMobile}

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

E-Pin Verify ตรวจสอบการซื้อบัตรเติมเงิน

POST https://topupapi.renny.co.th/topup/pos/v1/verifyTopupEpin/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/verifyTopupEpin/{customerMobile}

รายการ บัตรเติมเงิน ที่ทำรายการได้

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

E-Pin Confirm ยืนยันการซื้อบัตรเติมเงิน

POST https://topupapi.renny.co.th/topup/pos/v1/confirmTopupEPin/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/confirmTopupEPin/{customerMobile}

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

Postpaid Inquiry ตรวจสอบยอดชำระค่าโทรศัพท์รายเดือน

POST https://topupapi.renny.co.th/topup/pos/v1/inquiryPostpaidBill HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/inquiryPostpaidBill

รายการ postpaid ที่ทำรายการได้

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

Postpaid Verify ตรวจสอบการชำระค่าโทรศัพท์รายเดือน

POST https://topupapi.renny.co.th/topup/pos/v1/verifyPostpaidBill/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/verifyPostpaidBill/{customerMobile}

รายการ postpaid ที่ทำรายการได้

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

Prepaid Confirm ยืนยันการชำระ

POST https://topupapi.renny.co.th/topup/pos/v1/confirmPostpaidBill/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/confirmPostpaidBill/{customerMobile}

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description
)

Bill Inquiry ตรวจสอบยอดชำระ

POST https://topupapi.renny.co.th/topup/pos/v1/inquiryBill/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/inquiryBill

รายการ bill ที่ทำรายการได้

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

Bill Verify ตรวจสอบการชำระบิล

POST https://topupapi.renny.co.th/topup/pos/v1/verifyBill/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/verifyBill/{customerMobile}

รายการ bill ที่ทำรายการได้

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

Bill Confirm ยืนยันการชำระบิล

POST https://topupapi.renny.co.th/topup/pos/v1/confirmBill/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/confirmBill/{customerMobile}

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

List Data Packages ดึงข้อมูลรายการแพ็คเกจเสริม

POST https://topupapi.renny.co.th/topup/pos/v1/listDataPackage/{operator} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/listDataPackage/{operator}

รายการ operator ที่ทำรายการได้

Request Body

No request body

No request body

ตัวอย่าง response body

Response Body

Name Type Description

Data Package Verify ตรวจสอบข้อมูลการซื้อแพ็คเกจ

POST https://topupapi.renny.co.th/topup/pos/v1/verifyDataPackage/{operator}/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/verifyDataPackage/{operator}/{customerMobile}

รายการ operator ที่ทำรายการได้

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

E-Wallet Confirm ยืนยันการซื้อแพ็คเกจเสริม

POST https://topupapi.renny.co.th/topup/pos/v1/confirmDataPackage/{operator}/{customerMobile} HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/confirmDataPackage/{operator}/{customerMobile}

Request Body

Name Type M/O Description

ตัวอย่าง response body

Response Body

Name Type Description

Report

Get History Orders ดูประวัติการทำรายการ

POST https://topupapi.renny.co.th/topup/pos/v1/getHistoryOrders HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/getHistoryOrders

Request Body

Name Type M/O Description
page string M หมายเลขหน้า
orderPerPage string M จำนวนรายการต่อหน้า
createdDate string O วันที่ทำรายการ

ตัวอย่าง response body

Response Body

Name Type Description
status object สถานะ
data array ข้อมูล
orderId string เลขที่รายการ
mobile string เบอร์โทรศัพท์ที่ทำรายการ
serviceFee string ค่าธรรมเนียม
servicePrice string จำนวนเงินที่ทำรายการ
productName string ชื่อบริการ
responseCode string รหัสสถานะรายการ
responseMessage string สถานะรายการภาษาอังกฤษ
responseMessageTH string สถานะรายการภาษาไทย

Software

Get Software ดึงข้อมูล Software ล่าสุด

POST https://topupapi.renny.co.th/topup/pos/v1/getSoftware HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/getSoftware

Request Body

No request body

No request body

ตัวอย่าง response body

Response Body

Name Type Description
status object สถานะ
data object ข้อมูล
softwareVersion string เลข version ของ software
softwareUrl string url สำหรับ download software
assetVersion string เลข version ของ file
assetUrl string url สำหรับ download file

Get Product Detail ดึงข้อมูลบริการ

POST https://topupapi.renny.co.th/topup/pos/v1/getProductDetail HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
accept: application/json
Content-Type: application/json

ตัวอย่าง request body

POST https://topupapi.renny.co.th/topup/pos/v1/getProductDetail

Request Body

No request body

No request body

ตัวอย่าง response body

Response Body

Name Type Description
status object สถานะ
data object ข้อมูล
updatedAt string เวลาที่แก้ไขล่าสุด
categotyId number รหัสกลุ่มบริการ
categoryName string ชื่อกลุ่มบริการ
categoryDetail string รายละเอียดกลุ่มบริการ
status string สถานะบริการ
productId number รหัสบริการ
productName string ชื่อบริการ
price string ราคาของบริการ
fee string ค่าธรรมเนียม

Constants

Response Code

Code Message TH Message EN
0000 สำเร็จ SUCCESS
0001 การตรวจสอบข้อมูล ผิดพลาด Validation Error
0002 ไม่พบอุปกรณ์ Not Found Device
0003 การลงทะเบียน ผิดพลาด Registration Error
0004 การเปิดใช้งาน ผิดพลาด Activation Error
0005 ไม่พบข้อมูลสมาชิกของอุปกรณ์นี้ Device Has No Member
0006 ไม่พบข้อมูลสมาชิก Not Found Member
0007 อุปกรณ์นี้ยังไม่เปิดใช้งาน Device Has Not Been Activated
0008 อุปกรณ์นี้ถูกระงับชั่วคราว The Device Has Been Suspended
0009 อุปกรณ์นี้ลงทะเบียนแล้ว The Device Has Been Registerd
0010 รหัสผ่านไม่ถูกต้อง Invalid PIN
0011 อุปกรณ์นี้ถูกเปิดใช้งานแล้ว The Device Has Already Been Activated
0012 รหัสผ่านไม่ถูกต้อง Action PIN Not Found
0013 เลือกราคาไม่ถูกต้อง Invalid Price
0014 อุปกรณ์นี้ปิดใช้งานชั่วคราว Device Is Temporarily Closed
1001 เครดิตของสมาชิกไม่เพียงพอ Not Enough Member Credit
1002 บริการนี้ปิดใช้งานชั่วคราว Service Is Temporarily Closed
1003 ผิดพลาด รายการไม่สมบูรณ์ Unsuccessful Transaction
1004 เบอร์โทรศัพท์ไม่ถูกต้อง Wrong Mobile Number
1005 จำนวนเงินที่ทำรายการเกินลิมิตต่อรายการ Over Limit Amount Per Transaction
1006 เบอร์โทรศัพท์ถูกระงับชั่วคราว The Mobile Has Been Suspended
1007 สมาชิกถูกระงับชั่วคราว The Member Has Been Suspended
1008 การตรวจสอบข้อมูลไม่สำเร็จ Unsuccessful Verify Transaction
1009 ลูกค้าหยอดเงินไม่ครบ Not Enough Mobile Credit
1010 เลือกราคาไม่ถูกต้อง Invalid Amount
1011 การยืนยันทำรายการไม่สำเร็จ Unsuccessful Confirm Transaction
1012 ไม่พบข้อมูลที่ค้นหา Not found Inquiry Data
1013 จำนวนรายการเกินลิมิตต่อวัน Over Limit Transaction Per Day
2000 ผู้ให้บริการแจ้งว่าปิดบริการนี้ Broker Response Service Closed
2001 การทำรายการกับผู้ให้บริการเกิดความผิดพลาด Broker Response Error
2002 ผู้ให้บริการแจ้งว่าราคาไม่ถูกต้อง Broker Response Invalid Amount
2003 ผู้ให้บริการแจ้งว่าเครือข่ายไม่ถูกต้อง Broker Response Invalid Mobile Network
2004 การเชื่อมต่อกับผู้ให้บริการผิดพลาด Broker Connection Error
2005 รอผลการทำรายการจากผู้ให้บริการ Waiting Broker Callback
2007 ไม่พบรายการ Not Found Order
2008 การทำรายการสำเร็จไปแล้ว Order Has Been Completed
9001 เข้าสู่ระบบผิดพลาด Login Error
9002 โทเคนไม่ถูกต้อง Invalid Token
9003 โทเคนหมดอายุ Expired Token
9004 ไม่พบโทเคน Not Found Authorization Bearer Token
9005 บันทึกข้อมูลไม่ถูกต้อง Save Data Error
9006 ไม่พบรหัสหุ้นส่วน Partner ID Not Found
9007 ไม่พบรหัสผู้ให้บริการ Broker ID Not Found
9008 การตั้งค่าบริการไม่ถูกต้อง Product Config Not Found
9009 การตั้งค่าผู้ให้บริการไม่ถูกต้อง Broker Config Not Found
9010 ไม่พบการตรวจสอบข้อมูล Verify Data Not Found
9011 เกิดข้อผิดพลาดเกี่ยวกับวอลเล็ท Something Wrong With Wallet
9999 ผิดพลาดอื่นๆ Other Error
0 ดำเนินการสำเร็จ Success
000001 ระบบขัดข้อง ขออภัยในความไม่สะดวก System Error Null Master Response Code [XX, XXX]
171052 ท่านไม่สามารถซื้อแพคเกจเสริมนี้ได้ กรุณาติดต่อ 1242 Fail :: 824002 : Not allow to buy package
180025 เบอร์โทรศัพท์ของท่านไม่สามารถใช้งานได้ กรุณาติดต่อ 1242 The subscriber does not exist or is not active.
190003 ท่านทำรายการไม่สำเร็จ กรุณาลองใหม่อีกครั้ง Duplicate Transaction ID
190023 ระบบขัดข้อง ขออภัยในความไม่สะดวก System Error
191001 เบอร์โทรศัพท์ของท่านไม่ใช่เครือข่ายทรูมูฟ เอช แบบเติมเงิน No Data Found
191007 เบอร์ของท่านไม่สามารถใช้งานได้ กรุณาติดต่อ 1242 Account type is block
191012 เบอร์ของท่านไม่สามารถใช้งานได้ กรุณาติดต่อ 1242 Profile is block
191013 เบอร์ของท่านไม่สามารถใช้งานได้ กรุณาติดต่อ 1242 Status is block
191020 ระบบขัดข้อง ขออภัยในความไม่สะดวก Axis Fail
390058 ท่านทำรายการไม่สำเร็จ กรุณาลองใหม่อีกครั้ง Invalid command
390061 ท่านใส่เลขหมายไม่ถูกต้อง กรุณาใส่เลขหมายใหม่อีกครั้ง Invalid data
390063 ท่านทำรายการไม่สำเร็จ กรุณาลองใหม่อีกครั้ง Invalid Data Exception [Not Verify Yet. Error]
800007 ท่านทำรายการไม่สำเร็จ กรุณาลองใหม่อีกครั้ง Time Out
VAS001 แพคเกจเสริมนี้ไม่มีอยู่ในระบบ กรุณาลองใหม่อีกครั้ง VAS package not found
TWS001 ไม่พบ TrueMoney Wallet ของคุณ กรุณาสมัครใหม่ Could not found E-Wallet
TWS002 ระบบขัดข้อง ขออภัยในความไม่สะดวก System Error
TWS005 หมายเลขนี้ไม่สามารถทำรายการเติมเงินได้ กรุณาติดต่อ 1240 Inactive
TWS006 TrueMoney Wallet ของคุณมีวงเงินเกินกว่าที่กำหนด กรุณาตรวจสอบเงินในบัญชีของท่านก่อนทำรายการใหม่อีกครั้ง Over credit limit
2009 Broker Time Out Broker Time Out

Product ID Prepaid

Product ID Product Name
111 เติมเงิน 12CALL
112 เติมเงิน DTAC
113 เติมเงิน TRUEH
114 เติมเงิน PENGUIN
115 เติมเงิน MyByCat
116 เติมเงิน Myworld
117 เติมเงิน Feels

Product ID Wallet

Product ID Product Name
121 เติม TrueWallet

Product ID E-PIN

Product ID Product Name
2301 บัตร Ex Cash
2302 บัตร G Card
2303 บัตร GameIndy
2304 บัตร M Coins
2305 บัตร N Cash
2306 บัตร Ran Card
2307 บัตร SNS Plus
2308 บัตร V-Gold(Valofe)
2309 บัตร ACASH

Product ID Postpaid Bill

Product ID Product Name
141 ชำระค่าบิลโทรศัพท์รายเดือน AIS
142 ชำระค่าบิลโทรศัพท์รายเดือน DTAC
143 ชำระค่าบิลโทรศัพท์รายเดือน TRUEMOVEH"

Product ID General Bill

Product ID Product Name
2501 จ่ายบิล Aeon
2502 จ่ายบิล FirstChoice
2503 จ่ายบิล ซิตี้แอดวานซ์
2504 จ่ายบิล มิสทิน
2505 จ่ายบิล บัตรเครดิตเทสโก้ วีซ่า
2506 ธนาคารอาคารสงเคราะห์
2507 สินเชื่อเงินสดควิกแคช
2508 ธนาคารทิสโก้
2509 โตโยต้า ลีสซิ่ง
2510 สินเชื่อเพาเวอร์บาย
2511 บัตรเครดิตกรุงศรี
2512 บัตรเครดิตโฮมโปร วีซ่า
2513 สินเชื่อกรุงศรี เพอร์ซันนัล เครดิต
2514 สินเชื่อบุคคลเทสโก้
2515 บัตรเครดิตซิตี้แบงก์
2516 ซิตี้แบงก์ เรดดี้เครดิต
2517 บัตรเครดิตไทยพาณิชย์
2518 ธนาคารกสิกรไทย
2519 บัตรเครดิตสแตนดาร์ดชาร์เตอร์ด
2520 สินเชื่อสแตนดาร์ดชาร์เตอร์ด
2521 เคทีซี
2522 บัตรเครดิตยูโอบี
2523 นิสสัน ลีสซิ่ง
2524 ธนาคารเกียรตินาคิน
2525 พรูเด็นเชียล ประกันชีวิต
2526 กรุงเทพประกันภัย
2527 ไทยประกันชีวิต
2528 เมืองไทยประกันภัย
2529 เอไอเอ
2530 โตโยต้า อินชัวร์รันซ์ โบรกเกอร์
2531 ไทยพาณิชย์ สามัคคีประกันภัย
2532 ซิกน่าประกันภัย
2533 โตเกียวมารีนศรีเมืองประกันภัย
2534 บัตรเครดิต เซ็นทรัล
2535 ซิมเพิล วีซ่า โรบินชัน
2536 บัตรเครดิต ธนชาต
2537 บัตรเครดิต ซีไอเอ็มบี
2538 ไดเนอร์สคลับ
2539 บัตรสินเชื่อบุคคลธนชาต
2540 จ่ายบิล การไฟฟ้าส่วนภูมิภาค
2541 จ่ายบิล การไฟฟ้านครหลวง
2542 จ่ายบิล การประปานครหลวง

Product ID Data Package

Product ID Product Name Operator
2701 แพ็กเกจเสริม AIS เล่นเน็ต 3G/4G mpay
2702 แพ็กเกจเสริม DTAC dtac
2703 แพ็กเกจเสริม TRUE true
HTTP