นักพัฒนา

API & Documents

             ระบบ ePayment เป็นระบบตัดบัตรเครดิตแบบง่ายๆ โดยจะมีเว็บเพจสำหรับกรอกหมายเลขบัตรเครดิต ให้ร้านค้าเชื่อมต่อโดยตรง โดยร้านค้าจะมีหน้าที่ส่งค่าตัวแปรต่างๆ เช่น มูลค่าสินค้า หมายเลขประจำตัวร้านค้า มาให้เราดำเนินการเท่านั้น

             ร้านค้าซึ่งพัฒนาระบบฐานข้อมูลสินค้าและฐานข้อมูลลูกค้าเรียบร้อยแล้ว สามารถเข้ามาใช้บริการชำระเงินผ่านบัตรเครดิตกับ ePayment ได้ทันที

             พารามิเตอร์ที่ใช้ในการเชื่อมต่อกับระบบ ePayment ประกอบด้วยพารามิเตอร์ 2 ประเภท คือ “พารามิเตอร์หลัก” ที่ต้องระบุทุกครั้งเพื่อเชื่อมต่อกับระบบ ePayment และ “พารามิเตอร์เพิ่มเติม”

             เพื่อเป็นตัวเสริมให้กับระบบชำระเงินของร้านค้าทำงานได้สะดวกมากยิ่งขึ้น ซึ่งร้านค้าสามารถเลือกที่จะระบุเพื่อใช้งานพารามิเตอร์เพิ่มเติมนี้หรือไม่ก็ได้ โดยรายละเอียดของพารามิเตอร์ทั้ง 2 ประเภท มีดังต่อไปนี้

พารามิเตอร์ที่ใช้งานในระบบ

พารามิเตอร์ ชนิดข้อมูล ความยาวสูงสุด รายละเอียด
merchantid ตัวเลข 8 หมายเลข Merchant ID
refno ตัวเลข 10 หมายเลขอ้างอิงการสั่งซื้อ
customeremail ตัวอักษร 100 อีเมล์ลูกค้า
productdetail ตัวอักษร 255 รายละเอียดสินค้า
total ตัวเลข จำนวนไม่เกิน 9,999,999 มูลค่ารวมของสินค้า
lang (optional) ตัวอักษร 2 ภาษา
cc (optional) ตัวอักษร 2 หน่วยสกุลเงิน
postbackurl ตัวอักษร 500 URL เพื่อรับค่ากลับ
returnurl ตัวอักษร 500 URL เพื่อกลับไปยังเว็บไซต์ของร้านค้า

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

ร้านค้าจำเป็นจะต้องส่งพารามิเตอร์หลักทั้งหมด 5 ตัว โดยมีรายละเอียดดังนี้ ด้วยวิธีการส่งแบบ POST มาที่เว็บไซต์
https://www.thaiepay.com/epaylink/payment.aspx

    1. merchantid เป็นหมายเลข Merchant ID ที่ส่งไปให้ร้านค้าทางอีเมล์ในวันลงทะเบียนขอใช้บริการ พารามิเตอร์นี้มีชนิดข้อมูลเป็นตัวเลข ซึ่งมีความยาวทั้งหมด 8 ตัว
    2. refno เป็นหมายเลขอ้างอิงที่ร้านค้าใช้อ้างอิงรายการสั่งซื้อกับระบบ ePayment พารามิเตอร์นี้จะต้องเป็นหมายเลขที่ไม่ซ้ำกันในการสั่งซื้อแต่ละครั้ง ไม่เช่นนั้นจะเกิดการซ้อนทับกันในรายการสั่งซื้อ พารามิเตอร์นี้มีชนิดข้อมูลเป็นตัวเลข ซึ่งมีจำนวนสูงสุดได้ไม่เกิน 10 ตัว
    3. customeremail เป็นอีเมล์ของลูกค้าของร้านค้า ใช้สำหรับให้ระบบส่งอีเมล์ยืนยัน เมื่อการชำระเงินผ่านบัตรเครดิตผ่านเรียบร้อยแล้ว พารามิเตอร์นี้มีชนิดข้อมูลเป็นตัวอักษร ซึ่งมีความยาวได้ไม่เกิน 100 ตัวอักษร
    4. productdetail เป็นรายละเอียดสินค้าคร่าวๆ สำหรับสรุปบอกให้ลูกค้าเข้าใจว่า กำลังจ่ายเงินเพื่อซื้อสินค้าอะไร พารามิเตอร์นี้มีชนิดข้อมูลเป็นตัวอักษร ซึ่งมีความยาวได้ไม่เกิน 255 ตัวอักษร
    5. total เป็นมูลค่ารวมของสินค้า มีชนิดข้อมูลเป็นตัวเลข และสามารถส่งพารามิเตอร์นี้เป็นจุดทศนิยมได้ ตัวอย่างเช่น 199.50

พารามิเตอร์เพิ่มเติม

“พารามิเตอร์เพิ่มเติม” (Additional Parameter) เป็นพารามิเตอร์เพื่อเสริมการใช้งาน ซึ่งร้านค้าสามารถเลือกที่จะกำหนดเพื่อใช้งานหรือไม่กำหนดก็ได้ กล่าวคือ พารามิเตอร์ประเภทนี้จัดทำขึ้นเพื่อเอื้ออำนวยให้ร้านค้าสามารถใช้งานระบบชำระเงินของตนเองได้อย่างเต็มประสิทธิภาพ ซึ่งพารามิเตอร์เพิ่มเติมมีดังนี้

  1. “Lang คือ language (ภาษา) พารามิเตอร์นี้ เป็นตัวกำหนดให้เว็บเพจสามารถแสดงผลเป็นภาษาอังกฤษหรือภาษาไทย ซึ่งตามหลักการแสดงผลนี้จะยึดตามที่ร้านค้ากำหนดเอาไว้ก่อนแล้วในส่วนของระบบ Admin แต่หากมีการส่งพารามิเตอร์ lang เข้ามาภายหลังระบบจะเปลี่ยนการแสดงผลใหม่ทันที lang = “TH” แสดงผลเป็นภาษาไทย หรือ lang = “EN” แสดงผลเป็นภาษาอังกฤษ

    สาเหตุที่สร้างพารามิเตอร์นี้ขึ้น เพราะบางร้านค้าจะมีเว็บไซต์ที่สามารถแสดงผลได้ทั้งภาษาไทยและภาษาอังกฤษ จึงสร้างพารามิเตอร์นี้ขึ้นเพื่อช่วยอำนวยความสะดวกให้แก่ร้านค้า ทำให้ร้านค้าสามารถกำหนดพารามิเตอร์เพิ่มเติมได้เอง ว่าต้องการแสดงผลเป็นภาษาใดเมื่อใด

  2. cc คือ currency code ( หน่วยสกุลเงิน ) เป็นตัวกำหนดหน่วยของสกุลเงิน ซึ่งก็เป็นลักษณเดียวกับเรื่องของภาษาในข้อ 1 ร้านค้าจะกำหนดหน่วยสกุลเงินในระบบ admin เอาไว้เป็นหลักอยู่ก่อนแล้ว แต่ถ้ามีการส่งพารามิเตอร์ cc เข้ามาภายหลัง ระบบก็จะเปลี่ยนหน่วยสกุลเงินใหม่ให้ทันที

    เหตุผลก็คล้ายกับในข้อ 1. คือ ร้านค้าบางร้านค้มีสินค้าที่หลากหลายในหน่วยของสกุลเงิน พารามิเตอร์นี้จะทำให้ร้านค้าสามารถปรับหน่วยสกุลเงินได้ตามความต้องการ

  3. postbackurl เป็นพารามิเตอร์ที่กำหนดขึ้นเพื่อรายงานผลการชำระเงินกลับไปยังระบบชำระเงินของร้านค้า ซึ่งพารามิเตอร์นี้มีการทำงานคือ เมื่อร้านค้าทำการส่งค่าพารามิเตอร์หลักทั้งหมด เพื่อเชื่อมต่อกับระบบ ePayment โดยมีการกำหนดเพื่อใช้งานพารามิเตอร์ postbackurl ไปด้วยเรียบร้อยแล้ว ต่อจากนั้นลูกค้าทำการยืนยันการสั่งซื้อและการชำระเงินผ่านบัตรเครดิตดดยการกรอกข้อมูลบัตรเครดิตของตนแล้ว เมื่อการชำระเงิน “สมบูรณ์” ระบบจะทำการส่งค่ากลับไปรายงานผลการชำระเงินยังระบบชำระเงินของร้านค้าโดยอัตโนมัติ โดยอ้างอิงตามค่าพารามิเตอร์ postbackurl ที่กำหนดไว้ ในกรณีนี้ หากร้านค้าต้องการใช้งานพารามิเตอร์เพิ่มเติมตัวนี้ ร้านค้าจะต้องสร้าง URL มาหนึ่ง URL เพื่อรับค่าพารามิเตอร์กลับไปยังระบบชำระเงินของตน และการส่งค่าพารามิเตอร์ postbackurl ก็สามารถทำได้ โดยการระบุ URL ที่สร้างขึ้นนั้น ประกอบกับค่าพารามิเตอร์ ที่ต้องการรับกลับมายังระบบ

    ตัวอย่างเช่น
    http://www.yourdomain.com/complete.php?rid=0003444
    http://www.yourdomain.com/complete.php?rid=0003444&rid2=0003445

    * ข้อสังเกต พารามิเตอร์นี้จะส่งค่ากลับอย่างอัตโนมัติ ซึ่งร้านค้าสามารถดูผลการชำระเงินได้จาก URL ที่ระบุไว้

  4. returnurl เป้นพารามิเตอร์ที่กำหนดขึ้นเพื่อกลับไปยัง URL ที่กำหนดค่าไว้ หลังจากการชำระเงินสมบูรณ์แล้ว โดยเมื่อหน้าเว็บไซต์ได้แสดงผลว่าการชำระเงินสมบูรณ์แล้ว ต่อมาก็จะแสดงสถานะ “รอ” ประมาณ 5 นาที หลังจากนั้นหน้าเว็บเพจก็จะเปลี่ยนไปแสดงผลเป็นหน้าของ URL ตามที่ตั้งค่า returnurl ไว้ ร้านค้าที่ต้องการใช้งานพารามิเตอร์นี้จะต้องระบุ Return URL และส่งค่ามายังระบบ

CC หน่วยเงิน
“00” บาท
“01” USD
“02” Yen
“03” Singapore Doller
“04” Hongkong Dollar
“05” Euro Dollar
“06” GBP (Pound)
“07” Australian Dollar
“08” Swiss Franc

ตัวอย่างโค้ด HTML สำหรับส่งค่าเข้าระบบ

ด้านล่างนี้เป็นตัวอย่างโค้ด HTML ที่เขียนขึ้นเพื่อใช้ทดสอบการส่งค่า (พารามิเตอร์) ไปยังระบบ ePayment หากร้านค้าต้องการใช้งานโค้ดนี้ โปรดใส่พารามิเตอร์ merchantid และ customeremail ของตัวเองลงไปแล้วจึงค่อยดำเนินการทดสอบ

	
<html>
	<head>
		<title>EPAYLINK Testing</title>
	</head>
	<body bgcolor="#FFFFFF" text="#000000">
		<form method="post" action="https://www.thaiepay.com/epaylink/payment.aspx">
			<input type="hidden" name="refno" value="99999">
			<input type="hidden" name="merchantid" value="">
			<input type="hidden" name="c">
			<input type="hidden" name="productdetail" value="Testing Product">
			<input type="hidden" name="total" value="400">
			<br>
			<input type="submit" name="Submit" value="Comfirm Order">
		</form>
	</body>
</html>
	

ดาวน์โหลดคู่มือการเชื่อมต่อ ePayment

ข้อมูลบัตรเครดิตสำหรับการทดสอบ การชำระเงิน

Credit Card Number: 4311 1510 0999 9993 (Available for Demo Account Only)
CVV: 180
Expiry Data: 12/20
Credit Card Issuer: United Overseas Bank (Thai) Public Company Limited

Plug-in & Modules



เริ่มต้นและต่อยอดธุรกิจ ปรับกลยุทธ์การขายด้วยเครื่องมือออนไลน์กับ เพย์โซลูชั่น!