c h i l l p a y specification document version 1.1

46
b 1.1.12

Upload: others

Post on 04-Nov-2021

1 views

Category:

Documents


0 download

TRANSCRIPT

b

1.1.12

C H I L L P A Y – Specification Document Version 1.1.12

Page 2 of 46 For merchant only

Confidential

สารบญ

A. คมอในการพฒนาระบบ เพอเชอมตอกบบรการ ChillPay Payment Gateway ..................................................................................... 4

1. System Flow การทำงานของระบบ ChillPay Payment Gateway ...................................................................................................... 4

2. วธการเชอมตอจะแบงออกเปนทงหมด 3 รปแบบดงน ............................................................................................................................... 6

2.1 เชอมตอแบบใช Code Template โดยหนา UI การชำระเงนเปนของ ChillPay ................................................................................. 6

2.2 เชอมตอแบบ HTML Form โดยรานคาสามารถออกแบบ UI เองได ..................................................................................................... 9

2.3 เชอมตอแบบ API โดยรานคาสามารถออกแบบ UI เองได ................................................................................................................... 13

3. การสงขอมลผลการชำระเงนคาสนคา/บรการ กลบไปใหแกรานคา ม 2 วธดวยกน ................................................................................. 17

3.1 สงผลการชำระเงนแบบ Real Time (จำเปนตองม SSL Certificate) ................................................................................................. 17

3.2 สงผลกลบเมอกดปม “Go Back to Merchant Website” (สงผลกลบไปท URL Result) ................................................................ 21

4. การตรวจสอบสถานะของรายการ กรณทรานคาไมไดรบขอมลทสงกลบจากระบบ ChillPay Gateway ................................................. 22

5. ตวอยางหนาจอการชำระเงน .................................................................................................................................................................... 26

5.1 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Internet Banking .......................................................................................... 26

5.2 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Mobile Banking (K PLUS ) .......................................................................... 27

5.3 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Mobile Banking (SCB Easy App) .............................................................. 27

5.4 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Credit Card ..................................................................................................... 28

5.5 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : QR Payment ................................................................................................. 28

5.6 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Bill Payment .................................................................................................. 29

5.7 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Alipay ............................................................................................................. 29

5.8 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : WeChat Pay .................................................................................................. 30

5.9 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : True Money Wallet .................................................................................... 30

5.10 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : ShopeePay ............................................................................................... 31

5.11 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Installment (KBANK) .............................................................................. 31

5.12 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Installment (KTC FLEXI) ........................................................................ 32

5.13 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Pay with points (KTC FOREVER) ......................................................... 32

B. กรณรานคาตองการใชงานมากกวา 1 เวบไซต ............................................................................................................................................... 33

1. รานคาแจงความประสงคขอเปด RouteNo เพม ...................................................................................................................................... 33

2. รานคาแกไข URL Background และ URL Result ................................................................................................................................. 33

3. วธการเชอมตอ 3 รปแบบ ......................................................................................................................................................................... 33

3.1 การเชอมตอแบบใช Code Template .................................................................................................................................................. 34

C H I L L P A Y – Specification Document Version 1.1.12

Page 3 of 46 For merchant only

Confidential

3.2 การเชอมตอแบบใช HTML Form POST ขอมลมาท ChillPay ............................................................................................................. 35

3.3 การเชอมตอแบบ API ............................................................................................................................................................................. 36

4. เรยกดรายงาน ChillPay ตาม RouteNo ...................................................................................................................................................... 37

C. ขอมลการทดสอบบน Sandbox ..................................................................................................................................................................... 38

ขอมลหมายเลขบตรเครดต สำหรบทดสอบบน Sandbox ............................................................................................................................. 38

ขอมล Internet Banking สำหรบทดสอบบน Sandbox ............................................................................................................................. 38

ขอมล True Money Wallet สำหรบทดสอบบน Sandbox ........................................................................................................................ 38

ขนตอนทดสอบ Mobile Banking สำหรบทดสอบบน Sandbox ................................................................................................................ 39

ขนตอนทดสอบ QR Payment, Bill Payment, ShopeePay และ SCB Easy App สำหรบทดสอบบน Sandbox .............................. 39

ขนตอนทดสอบ Alipay และ WeChat Pay สำหรบทดสอบบน Sandbox................................................................................................. 39

D. ภาคผนวก ......................................................................................................................................................................................................... 40

ภาคผนวก ก. ..................................................................................................................................................................................................... 40

ภาคผนวก ข. ..................................................................................................................................................................................................... 40

ภาคผนวก ค. ..................................................................................................................................................................................................... 42

ภาคผนวก ง. ..................................................................................................................................................................................................... 42

ภาคผนวก จ. ..................................................................................................................................................................................................... 43

ภาคผนวก ฉ. ..................................................................................................................................................................................................... 44

ภาคผนวก ช. ..................................................................................................................................................................................................... 44

ภาคผนวก ซ. ..................................................................................................................................................................................................... 45

C H I L L P A Y – Specification Document Version 1.1.12

Page 4 of 46 For merchant only

Confidential

A. คมอในการพฒนาระบบ เพอเชอมตอกบบรการ ChillPay Payment Gateway

1. System Flow การทำงานของระบบ ChillPay Payment Gateway System Flow แสดงการทำงานและการรบ-สงขอมลระหวางเซฟเวอรของ ChillPay และเซฟเวอรของรานคา

1.1 ลกคา (End User) ทำรายการสงซอสนคาหรอบรการบนหนาเวบไซต หรอ Mobile Application ของทางรานคา (Merchant)

และทำการกด Checkout เพอจะทำการยนยนการสงซอสนคา 1.2 ลกคาทำการเลอกชองการการชำระเงนทตองการ จากนนทำการกดปมยนยนการชำระเงนบนหนาเวบไซตของรานคา 1.3 ระบบเวบไซตของทางรานคาทำการเรยกเซอรวส (API) เพอขอสรางรายการสำหรบการชำระเงนตามชองทางทลกคาเลอกจาก

ขอ 2 เสรจแลวหนาเวบไซตจะทำการ Redirect ไปทระบบของ ChillPay 1.4 ระบบ ChillPay จะทำการสรางรายการ Transaction ของการชำระเงนตามชองทางทเลอก จากนนระบบจะทำการ POST ขอมล

ตอไปยงเวบไซตของทางธนาคาร หรอ Payment Gateway ตามทไดเลอกไวในขอ 2 1.5 ลกคาทำการกรอกขอมลเพอลอกอนเขาระบบของทางธนาคาร 1.6 ลกคาทำการเลอก Account ของบญชเงนฝากทตองการชำระเงน (กรณทลกคามมากกวา 1 บญช) 1.7 ลกคาทำการ Request เพอขอ OTP สำหรบใชยนยนการชำระเงน จากนนกรอกรหส OTP เพอยนยนการชำระเงน 1.8 แสดงขอมลสรปผลของการชำระเงน (รายละเอยดแตกตางกนตามแตละธนาคาร)

C H I L L P A Y – Specification Document Version 1.1.12

Page 5 of 46 For merchant only

Confidential

1.9 ลกคาทำการกดปม Back To Merchant เพอกลบไปยงหนาเวบไซตของทางรานคา (กลบไปทหนาเวบไซตของ ChillPay และระบบธนาคารจะสงผลลพธของการชำระเงนกลบไปทเซฟเวอรของ ChillPay

1.10 ระบบ ChillPay ทำการ Process ผลการลพธจากการชำระเงนทไดรบจากทางธนาคาร จากนนทำการสงผลลพธการชำระเงนกลบไปทเซฟเวอรของทางรานคา (Merchant)

1.11 จากนนระบบ ChillPay จะทำการสงขอมลแบบ POST กลบไปทเซฟเวอรของทางรานคา ตาม URL Background ทรานคาไดระบเอาไวในระบบของ ChillPay (โดยทางรานคาสามารถเขาไปแกไขไดดวยตนเองตามหวขอท 5. ) โดยจะมขอมลพารามเตอรสงกลบไปใหตามหวขอท 3.1

1.12 หนาเวบไซตของ ChillPay จะทำการ Redirect กลบไปทเวบไซตของรานคาโดยอตโนมต ตาม URL Result ตามทรานคาไดระบไวในระบบของ ChillPay (โดยทางรานคาสามารถเขาไปแกไขไดดวยตนเองตามหวขอท 5. ) โดยจะมขอมลพารามเตอรสงกลบไปใหรานคาตามหวขอท 3.2

C H I L L P A Y – Specification Document Version 1.1.12

Page 6 of 46 For merchant only

Confidential

2. วธการเชอมตอจะแบงออกเปนทงหมด 3 รปแบบดงน

2.1 เชอมตอแบบใช Code Template โดยหนา UI การชำระเงนเปนของ ChillPay ทางรานคาสามารถทำการ Copy code html template และวางบนหนาเวบไซตของรานคา โดยมขอมลจำเปนทตองสงคาไปทระบบของ ChillPay ดงตอไปน - URL สำหรบ POST ขอมลบน Sandbox: https://sandbox-cdnv3.chillpay.co/Payment/ - URL สำหรบ POST ขอมลบน Production: https://cdn.chillpay.co/Payment/

C H I L L P A Y – Specification Document Version 1.1.12

Page 7 of 46 For merchant only

Confidential

ตารางท 2.1 : รายละเอยดของ Html Tag Parameter เพอใชสำหรบสราง Form ในการสงคามายงระบบ ChillPay

No. Parameter Data Type

Length Mandatory / Optional

Description Remark

1 data-merchantid String 15 M Merchant ID. เปนคาทจะออกใหโดย ChillPay เชน M000001

2 data-orderno String 20 M เลขท Order หรอรหสอางองของรายการ

เปนคาทออกโดยรานคา ตองเปนคาเฉพาะทไมซำกน และตองเปนตวเลขอยางเดยว หรอตวเลขผสมรวมกบตวอกษรภาษาองกฤษเทานน หามมตวอกษรอกขระพเศษ เชน +-*/-#$_ หรออน ๆ

3 data-customerid String 100 M รหสอางองของลกคา(End User) หรอชอลกคา

เชน CUS000001 หรอ นายแบงก มมาก สามารถเวนวรรคตรงกลางไดเทานน ไมรองรบการเวนวรรคตำแหนงแรกหรอตำแหนงสดทาย และหามมตวอกษรอกขระพเศษ เชน +-*/-#$_ หรออน ๆ

4 data-amount Number 12 M จำนวนเงนทชำระของรายการ (2 หลกสดทายจะเปนคาทศนยม) *สกลเงน JPY และ KRW จะไม มหนวยทศนยม

ตวอยางเชน สงคาเขามาเปน 55025 ระบบจะอานคาเปน 550.25 สวนสกลเงน JPY และ KRW ระบบจะอานคาเปน 55025.00

5 data-mobileno String 10 O เบอรโทรศพทมอถอของลกคา(End User)

ในกรณทเลอกชำระผานชองทาง K PLUS จำเปนตองระบเบอรมอถอของลกคาทลงทะเบยนในระบบของ K PLUS เทานน

6 data-description String 100 O ขอมลรายละเอยดในการชำระเงน

เชน “สนคาไอโฟน X 64GB Color-Black”

7 data-currency String 3 M ขอมลรหสสกลเงน ใหกำหนดคาเปน “764”

เชน 764 ดรายละเอยดในภาคผนวก ฉ.

8 data-lang String 2 O รหสภาษาทจะแสดงบนหนาเวบไซตชำระเงนของทางธนาคาร

TH: ภาษาไทย EN: ภาษาองกฤษ

C H I L L P A Y – Specification Document Version 1.1.12

Page 8 of 46 For merchant only

Confidential

9 data-routeno Number 1 M Route No. Default: 1

เปนคาทจะออกใหโดยระบบ ChillPay เชน 1 หากรานคาตองการใชงานมากกวา 1 เวบไซต สามารถตดตอไดท [email protected]

10 data-clientip String 20 M ขอมล IP Address ของลกคา

เชน 203.255.255.155

11 data-apikey String 100 M รหส Api Key ทใชในการเชอมตอระบบ

เปนคาทจะออกใหโดย ChillPay

12 data-tokenflag String 1 O ในกรณทเลอกชำระเงนดวย Credit Card หากตองการชำระเงนโดยใช Token ใหระบคาเปน “Y”

Y: ชำระเงนแบบใช Token N: ชำระเงนแบบไมใช Token (เปนคา Default)

13 data-cardtoken String 100 O ขอมล Token สำหรบการชำระเงนดวย Credit Card หากระบขอมล data-tokenflag เปน “Y” จำเปนตองระบขอมลในสวนนดวย

คา Token จะเปนคาทออกใหโดยระบบ ChillPay

14 data-creditmonth Number 2 O จำนวนเดอนทผอนชำระ สำหรบการทำรายการผอนชำระผาน Credit Card

เชน 3 , 8 , 10

15 data-shopid String 2 O คา Shop ID สำหรบการทำรายการผอนชำระผาน Credit Card

01 : สำหรบรานคาเปนคนรบภาระดอกเบย 02: สำหรบลกคา (End User) เปนคนรบภาระดอกเบย

16 data-imageurl String 255 O URL ของรปสนคาสำหรบแสดงบนหนาชำระเงนของ Rabbit LINE Pay

เชน https://image.com/image-product-01.jpg

17

data-custemail String 100 O ขอมล Email ของลกคา

เชน [email protected]

C H I L L P A Y – Specification Document Version 1.1.12

Page 9 of 46 For merchant only

Confidential

2.2 เชอมตอแบบ HTML Form โดยรานคาสามารถออกแบบ UI เองได ในกรณทรานคาตองการสรางหนาจอ (UI) เฉพาะของรานคาเอง สามารถใชขอมล Parameter ตามตารางท 2.2 เพอสรางฟอรมสำหรบสงคา POST มายงระบบ ChillPay ตารางท 2.2 : Request Parameter สำหรบสงคา POST ในการทำรายการ Payment มายงระบบ ChillPay

No. Parameter Data Type

Length Mandatory / Optional

Description Remark

1 MerchantCode String 15 M Merchant ID. เปนคาทจะออกใหโดย ChillPay เชน M000001

2 OrderNo String 20 M เลขท Order หรอรหสอางองของรายการ

เปนคาทออกโดยรานคา ตองเปนคาเฉพาะทไมซำกน และตองเปนตวเลขอยางเดยว หรอตวเลขผสมรวมกบตวอกษรภาษาองกฤษเทานน หามมตวอกษรอกขระพเศษ เชน +-*/-#$_ หรออน ๆ

3 CustomerId String 100 M รหสอางองของลกคา (End User) หรอชอลกคา

เชน CUS000001 หรอ นายแบงก มมาก สามารถเวนวรรคตรงกลางไดเทานน ไมรองรบ การเวนวรรคตำแหนงแรกหรอตำแหนงสดทาย และหามมตวอกษรอกขระพเศษ เชน +-*/-#$_ หรออน ๆ

4 Amount Number 12 M จำนวนเงนทชำระของรายการ (2 หลกสดทายจะเปนคาทศนยม) *สกลเงน JPY และ KRW จะไม มหนวยทศนยม

ตวอยางเชน สงคาเขามาเปน 55025 ระบบจะอานคาเปน 550.25 สวนสกลเงน JPY และ KRW ระบบจะอานคาเปน 55025.00

5 PhoneNumber String 10 O เบอรโทรศพทมอถอของลกคา(End User)

ในกรณทเลอกชำระผานชองทาง K PLUS จำเปนตองระบเบอรมอถอของลกคาทลงทะเบยนในระบบของ K PLUS เทานน

6 Description String 100 O ขอมลรายละเอยดในการชำระเงน

เชน “สนคาไอโฟน X 64GB Color-Black”

7 ChannelCode String 30 M รหสอางองแทนธนาคารทรบชำระ

เชน internetbank_bay ดรายละเอยดในภาคผนวก จ.

C H I L L P A Y – Specification Document Version 1.1.12

Page 10 of 46 For merchant only

Confidential

8 Currency String 3 M ขอมลรหสสกลเงน ใหกำหนดคาเปน “764”

เชน 764 ดรายละเอยดในภาคผนวก ฉ.

9 LangCode String 2 O รหสภาษาทจะแสดงบนหนาเวบไซตชำระเงนของทางธนาคาร

TH: ภาษาไทย EN: ภาษาองกฤษ

10 RouteNo Number 1 M Route No. Default: 1

เปนคาทจะออกใหโดยระบบ ChillPay เชน 1 หากรานคาตองการใชงานมากกวา 1 เวบไซต สามารถตดตอไดท [email protected]

11 IPAddress String 20 M ขอมล IP Address ของลกคา

เชน 203.255.255.155

12 ApiKey String 100 M รหสอางองทใชในการเชอมตอระบบ

เปนคาทจะออกใหโดย ChillPay

13 TokenFlag String 1 O ในกรณทเลอกชำระเงนดวย Credit Card หากตองการชำระเงนโดยใช Token ใหระบคาเปน “Y”

Y: ชำระเงนแบบใช Token N: ชำระเงนแบบไมใช Token (เปนคา Default)

14 CreditToken String 100 O ขอมล Token สำหรบการชำระเงนดวย Credit Card หากระบขอมล TokenFlag เปน “Y” จำเปนตองระบขอมลในสวนนดวย

คา Token จะเปนคาทออกใหโดยระบบ ChillPay

15 CreditMonth Number 2 O จำนวนเดอนทผอนชำระ สำหรบการทำรายการผอนชำระผาน Credit Card

เชน 3 , 8 , 10

C H I L L P A Y – Specification Document Version 1.1.12

Page 11 of 46 For merchant only

Confidential

16 ShopID String 2 O คา Shop ID สำหรบการทำรายการผอนชำระผาน Credit Card

01 : สำหรบรานคาเปนคนรบภาระดอกเบย 02: สำหรบลกคา (End User) เปนคนรบภาระดอกเบย

17 ProductImageUrl String 255 O URL ของรปสนคาสำหรบแสดงบนหนาชำระเงนของ Rabbit LINE Pay

เชน https://image.com/image-product-01.jpg

18 CustEmail String 100 O ขอมล Email ของลกคา

เชน [email protected]

19 CheckSum String 32 M ผลลพธทไดจากการนำคาทงหมดไปเขารหส MD5

ใชเพอยนยนความถกตองของรายการ

ระบบ ChillPay Payment Gateway ไดเพมระดบความปลอดภยและความเชอมนในการรบ-สงขอมลจากระบบของรานคามายง ChillPay โดยใหรานคาทำการเขารหสของขอมลดวยวธการ MD5 Checksum ขอมลกอนสงเขามาทระบบของ ChillPay โดยดำเนนการดงน

1. นำคาขอมลจาก Parameter ทงหมดจากขอ 1 – 18 จากตารางท 2.2 มาเรยงตอกน 2. เพมคาสดทาย MD5 Secret Key ททาง ChillPay กำหนดใหมาตอทายตวแปรในตารางท 2.2 (รานคาจะตองเกบขอมล MD5 Secret

Key ไวเปนความลบระหวางรานคา และ ระบบ ChillPay เทานน หามเปดเผยขอมล MD5 Secret Key ใหกบผไมเกยวของทราบเปนอนขาด)

3. ทำการ Hash ขอมลดวยวธการ MD5 ดรายละเอยดไดจาก https://en.wikipedia.org/wiki/MD5 เมอ Hash แลวจะไดคา MD5 Hash นำมาใชเปนคา Parameter สำหรบตวแปร CheckSum (ตามขอ 19 ในตารางท 2.2) เพอ POST รายการมาทระบบ ChillPay Payment Gateway

** หมายเหต **

- คา CheckSum เปนการนำคาจาก Parameter ตาง ๆ ตามตารางท 2.2 (ขอ 1 – 18) มาเรยงตอกน แลวตอทายดวย MD5 Secret Key (ทไดรบจากทาง ChillPay) ดงน MerchantCode + OrderNo + CustomerId + Amount + PhoneNumber + Description + ChannelCode + Currency + LangCode + RouteNo + IPAddress + APIKey + TokenFlag + CreditToken + CreditMonth + ShopID + ProductImageUrl + CustEmail + MD5 Secret Key จากนนนำขอมลทเรยงกนทงหมดนไปเขารหสดวยฟงกชน MD5 Hashing จงจะไดเปนคา CheckSum

ตวอยาง การนำขอมลมาเรยงตอกนเพอเขาฟงกชน MD5 XXXXX180523154918100001200000888889999Test Paymentcreditcard764TH1205.55.66.177aaaabbbbccccddddeeeeffffgggghhhhkkkkaaaabbbbddddssssaaaabbbbssssXXXMDSECRETKEYXXX

C H I L L P A Y – Specification Document Version 1.1.12

Page 12 of 46 For merchant only

Confidential

ตวอยาง การสรางฟอรมในการชำระเงน เพอ POST ขอมลมายงหนาเวบไซตของ ChillPay Payment Gateway

<!DOCTYPE html> <html><head> <meta charset="utf-8" /> <title>Payment</title> </head> <body>

<form id="form1" action="https://sandbox-cdnv3.chillpay.co/Payment/" method="post"> <input type="hidden" name="MerchantCode" value="XXXX"> <input type="hidden" name="OrderNo" value="00001"> <input type="hidden" name="CustomerId" value="00003"> <input type="hidden" name="Amount" value="20000">

<input type="hidden" name="PhoneNumber" value="0888889999"> <input type="hidden" name="Description" value="Test Payment"> <input type="hidden" name="ChannelCode" value="creditcard ">

<input type="hidden" name="Currency" value="764"> <input type="hidden" name="LangCode" value="TH">

<input type="hidden" name="RouteNo" value="1"> <input type="hidden" name="IPAddress" value="192.1.1.177">

<input type="hidden" name="APIKey" value="aaaabbbbccccddddeeeeffffgggghhhhkkkkaaaa"> <input name="TokenFlag" type="hidden" value="N">

<input name="CreditToken" type="hidden" value=""> <input name="CreditMonth" type="hidden" value="6"> <input name="ShopID" type="hidden" value=""> <input name="ProductImageUrl" type="hidden" value=""> <input name="CustEmail" type="hidden" value="">

<input type="hidden" name="CheckSum" value="55f09f04cb5562341d55e92e55a5e5e5"> </form>

</body></html>

C H I L L P A Y – Specification Document Version 1.1.12

Page 13 of 46 For merchant only

Confidential

2.3 เชอมตอแบบ API โดยรานคาสามารถออกแบบ UI เองได ในกรณทรานคาตองการเชอมตอเปนแบบ API สามารถใชขอมล Parameter ตามตารางท 2.2 เพอใชสำหรบสงคา POST มายงระบบ ChillPay โดยทำการเรยกมายง URL ดงตอไปน

- URL สำหรบ POST ขอมลบน Sandbox : https://sandbox-appsrv2.chillpay.co/api/v2/Payment/ - URL สำหรบ POST ขอมลบน Production : https://appsrv.chillpay.co/api/v2/Payment/

ตวอยาง การเรยก Request Payment Service (Code ภาษา PHP)

<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => "https://sandbox-appsrv2.chillpay.co/api/v2/Payment/", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => "MerchantCode=XXXXX&OrderNo=00001&CustomerId=100001&Amount=25000&PhoneNumber=0890000000&Description=Test-Payment&ChannelCode=internetbank_bay&Currency=764&LangCode=TH&RouteNo=1&IPAddress=127.0.0.1&APIKey=ZZZZZZZZZZZZZZZZ&[email protected]&CheckSum=4048167757bc0f670c9612af8d2677d5", CURLOPT_HTTPHEADER => array( "Cache-Control: no-cache", "Content-Type: application/x-www-form-urlencoded" ), )); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; }

C H I L L P A Y – Specification Document Version 1.1.12

Page 14 of 46 For merchant only

Confidential

ตวอยาง การเรยก Request Payment Service (Code ภาษา C# .NET)

ตารางท 2.3 : Response Parameter ทสงกลบไปให Server ของทางรานคา

No. Parameter Data Type Length Description Remark 1 Status Number 1 รหสผลของการทำรายการ(ลำดบท

1) อางอง ภาคผนวก ก.

2 Code Number 5 รหสผลของการทำรายการ(ลำดบท 2)

อางอง ภาคผนวก ข.

3 Message String 255 คำอธบายผลของการทำรายการ(ลำดบท 2)

อางอง ภาคผนวก ข.

4 TransactionId Number 20 เลขทอางองรายการสำหรบรานคา เพอใชสำหรบตรวจสอบรายการอางองระหวางรานคา กบ ChillPay เชน 10071

6 Amount Number 12 จำนวนเงนทชำระของรายการ (2 หลกสดทายจะเปนคาทศนยม) *สกลเงน JPY และ KRW จะไม มหนวยทศนยม

ตวอยางเชน สงคาเขามาเปน 55025 ระบบจะอานคาเปน 550.25 สวนสกลเงน JPY และ KRW ระบบจะอานคาเปน 55025.00

6 OrderNo String 20 เลขท Order หรอรหสอางองของรายการ

คาทไดรบมาจากรานคา

7 CustomerId String 100 รหสอางองของลกคา(End User) หรอชอลกคา

คาทไดรบมาจากรานคา

8 ChannelCode String 20 รหสอางองแทนธนาคารทรบชำระ เชน internetbank_bay ดรายละเอยดในภาคผนวก จ.

var client = new RestClient("https://sandbox-appsrv2.chillpay.co/api/v2/Payment/"); var request = new RestRequest(Method.POST); request.AddHeader("cache-control", "no-cache"); request.AddHeader("Content-Type", "application/x-www-form-urlencoded"); request.AddParameter("form-data", "MerchantCode=XXXXX&ChannelCode=internetbank_bay&RouteNo=1&OrderNo=00001&Amount=5000&CustomerId=C000001&Description=test-payment&PhoneNumber=0880999999&LangCode=TH&ApiKey=XXXXXXXXXXX&[email protected]&CheckSum=34670712dcaaf5e33792d15c9dfa85c7", ParameterType.RequestBody); IRestResponse response = client.Execute(request);

C H I L L P A Y – Specification Document Version 1.1.12

Page 15 of 46 For merchant only

Confidential

9 ReturnUrl String 255 URL ทจะแสดงเมอลกคาทำรายการสำเรจ

เปนหนาเวบไซตของทางรานคา (Result URL)

10 PaymentUrl String 255 URL ทจะทำการ Redirect ไปหนาชำระเงนของธนาคาร

ทางรานคาจะตองเขยนโปรแกรมให Redirect ไปท URL น

11 IpAddress String 20 IP Address ของลกคาททำรายการ

เชน 20.25.55.20

12 Token String 60 รหส Token สำหรบอางองรายการ

ใชสำหรบ ChillPay

13 CreatedDate String 20 วนททำรายการ รปแบบ: YYYYMMDDHHMMSS เชน 20180712173122

14 ExpiredDate String 20 วนทรายการหมดอาย รปแบบ: YYYYMMDDHHMMSS เชน 20180713173122

C H I L L P A Y – Specification Document Version 1.1.12

Page 16 of 46 For merchant only

Confidential

ตวอยาง ขอมล JSON Response Message ทไดรบจากการเรยก API

{ "Status": 0, "Code": 200, "Message": "Success", "TransactionId": 210, "Amount": 5000, "OrderNo": "20170929070743", "CustomerId": "000001", "ChannelCode": "internetbank_bay", "ReturnUrl": "http://localhost:8000/chillpay/response/success.php", "PaymentUrl": "https://sandbox-cdnv3.chillpay.co/payment/0935787fee3017ed65c8b8f36451d662db3400c4/internetbank", "IpAddress": "127.0.0.1", "Token": "0935787fee3017ed65c8b8f36451d662db3400c4", "CreatedDate": "20180712173122", "ExpiredDate": "20180713173122"

}

C H I L L P A Y – Specification Document Version 1.1.12

Page 17 of 46 For merchant only

Confidential

3. การสงขอมลผลการชำระเงนคาสนคา/บรการ กลบไปใหแกรานคา ม 2 วธดวยกน

3.1 สงผลการชำระเงนแบบ Real Time (จำเปนตองม SSL Certificate) ChillPay Gateway จะสงผลการชำระเงนแบบ Real Time กลบไปทเซฟเวอรของทางรานคาทาง URL Background ตามทรานคาไดแจงไวตอนสมครเปดใชบรการ ดวย Method [POST] โดยจะสงขอมลเปน Background Process ซงทางลกคาจะไมเหน URL หรอหนาเวบดงกลาวน ตารางท 3.1 : Response Parameter ทสงกลบไปให Server ของทางรานคา

No. Parameter Data Type Length Description Remark 1 TransactionId Number 20 เลขทอางองรายการสำหรบรานคา เพอใชสำหรบตรวจสอบ

รายการอางองระหวางรานคา กบ ChillPay เชน 10071

2 Amount Number 12 จำนวนเงนทชำระของรายการ (2 หลกสดทายจะเปนคาทศนยม) *สกลเงน JPY และ KRW จะไม มหนวยทศนยม

ตวอยางเชน สงคาเขามาเปน 55025 ระบบจะอานคาเปน 550.25 สวนสกลเงน JPY และ KRW ระบบจะอานคาเปน 55025.00

3 OrderNo String 20 เลขท Order หรอรหสอางองของรายการ

คาทไดรบมาจากรานคา

4 CustomerId String 100 รหสอางองของลกคา(End User) หรอชอลกคา

คาทไดรบมาจากรานคา

5 BankCode String 20 รหสอางองแทนธนาคารทรบชำระ เชน internetbank_bay ดรายละเอยดในภาคผนวก จ.

6 PaymentDate String 20 วนททำรายการชำระเงน Format: YYYYMMDDHHMMSS เชน 20170908125132

7 PaymentStatus Number 1 รหสผลการชำระเงนจากทางธนาคาร

อางอง ภาคผนวก ค.

8 BankRefCode String 50 รหสอางองรายการจากทางธนาคาร

เพอใชตรวจสอบรายการกบทางธนาคาร

9 CurrentDate String 10 วนทปจจบนททำการสงขอมล Format: YYYYMMDD เชน 20170908

10 CurrentTime String 10 เวลาปจจบนททำการสงขอมล Format: HHMMSS เชน 125132

11 PaymentDescription String 100 รายละเอยดรายการชำระเงน เชน สนคาไอโฟน X-XS 12 CreditCardToken String 100 ขอมล Token สำหรบการชำระ

เงนดวย Credit Card โดยทหนาเวบของ Credit Card จะทำการ

เชน “fexdff55efsd8e5fsd8e5sf4ds44fefasd6fsd8e1fs8fe1ws8d”

C H I L L P A Y – Specification Document Version 1.1.12

Page 18 of 46 For merchant only

Confidential

auto fill ขอมลบตรใหเลยลกคาไมตองกรอกขอมลเอง

13 Currency String 3 ขอมลรหสสกลเงน เชน 764 ดรายละเอยดในภาคผนวก ฉ.

14 CustomerName String 50 ชอผชำระเงน เฉพาะชองทาง QR Payment

15 CheckSum String 32 ผลลพธทไดจากการนำขอมลทงหมดไปเขารหส MD5

ใชเพอยนยนความถกตองของขอมล

** หมายเหต **

- คา CheckSum เปนการนำคาจาก Parameter ตาง ๆ ตามตารางท 3.1 (ขอ 1 – 14) มาเรยงตอกน แลวตอทายดวย MD5 Secret Key (ทไดรบจากทาง ChillPay) ดงน TransactionId + Amount + OrderNo + CustomerId + BankCode + PaymentDate + PaymentStatus + BankRefCode + CurrentDate + CurrentTime + PaymentDescription + CreditCardToken + Currency + CustomerName + MD5 Secret Key จากนนนำขอมลทเรยงกนทงหมดนไปเขารหสดวยฟงกชน MD5 Hashing จงจะไดเปนคา “CheckSum”

- ใชคำสง URL Encode สำหรบขอมลดงตอไปน คอ MD5 Secret Key ตวอยาง การนำขอมลมาเรยงตอกนเพอเขาฟงกชน MD5 999920000000001100001bank_qrcode20190125132533063684020190125132533Test Payment764นายแบงก มมากABCDEFGHJKMOPQRSTUVWXYZ

C H I L L P A Y – Specification Document Version 1.1.12

Page 19 of 46 For merchant only

Confidential

ตวอยาง ขอมลผลการชำระเงนทสงกลบไปให Server ของทางรานคา (Code ภาษา PHP)

<?php $response_message = array(

"TransactionId" => $_POST['TransactionId'], "Amount" => $_POST['Amount'], "OrderNo" => $_POST['OrderNo'], "CustomerId" => $_POST['CustomerId'], "BankCode" => $_POST['BankCode'], "PaymentDate" => $_POST['PaymentDate'], "PaymentStatus" => $_POST['PaymentStatus'], "BankRefCode" => $_POST['BankRefCode'], "CurrentDate" => $_POST['CurrentDate'], "CurrentTime" => $_POST['CurrentTime'], "PaymentDescription" => $_POST['PaymentDescription'], "CreditCardToken" => $_POST['CreditCardToken'], "Currency" => $_POST['Currency'], "CustomerName" => $_POST['CustomerName'], "CheckSum" => $_POST['CheckSum'],

); ?> ตวอยาง output จาก $_POST TransactionId=9999&Amount=20000&OrderNo=000001&CustomerId=100001&BankCode=bank_qrcode&PaymentDate=20190125132533&PaymentStatus=0&BankRefCode=636840&CurrentDate=20190125&CurrentTime=132533&PaymentDescription=Test Payment&CreditCardToken=&Currency=764&CustomerName=นายแบงก มมาก&CheckSum=55f09f04cb5562341d55e92e55a5e5e5

C H I L L P A Y – Specification Document Version 1.1.12

Page 20 of 46 For merchant only

Confidential

ตวอยาง ขอมลผลการชำระเงนทสงกลบไปให Server ของทางรานคา (Code ภาษา #C .NET)

int transactionId = Request.Form["TransactionId"]; decimal amount = Request.Form["Amount"]; string orderNo = Request.Form["OrderNo"]; string customerId = Request.Form["CustomerId"]; string bankCode = Request.Form["BankCode"]; string paymentDate = Request.Form["PaymentDate"]; int paymentStatus = Request.Form["PaymentStatus"]; string bankRefCode = Request.Form["BankRefCode"]; string currentDate = Request.Form["CurrentDate"]; string currentTime = Request.Form["CurrentTime"]; string paymentDescription = Request.Form["PaymentDescription"]; string creditCardToken = Request.Form["CreditCardToken"]; string currency = Request.Form["Currency"]; string customerName = Request.Form["CustomerName"]; string checkSum = Request.Form["CheckSum"]; ตวอยาง output จาก Request.Form TransactionId=9999&Amount=20000&OrderNo=000001&CustomerId=100001&BankCode=bank_qrcode&PaymentDate=20190125132533&PaymentStatus=0&BankRefCode=636840&CurrentDate=20190125&CurrentTime=132533&PaymentDescription=Test Payment&CreditCardToken=&Currency=764&CustomerName=นายแบงก มมาก&CheckSum=55f09f04cb5562341d55e92e55a5e5e5

C H I L L P A Y – Specification Document Version 1.1.12

Page 21 of 46 For merchant only

Confidential

3.2 สงผลกลบเมอกดปม “Go Back to Merchant Website” (สงผลกลบไปท URL Result) เมอลกคากดปม “Go Back to Merchant Website” (กรณทำรายการสำเรจ) หรอ “Cancel” (กรณยกเลกรายการ) หนาจอเวบไซตของทางธนาคารจะ Redirect กลบไปยงหนาจอเวบไซตของทางรานคาท URL Result ทรานคาไดแจงไวกบทาง ChillPay และระบบ ChillPay Gateway จะแจงผลการทำรายการกลบไปตามตวแปรดงตารางดานลางน ดวย Method [POST] ตารางท 3.2 : Response Parameter ทสงกลบไปใหทางหนาเวบไซตของรานคา

No. Parameter Data Type Length Description Remark 1 respCode Number 1 รหสผลของการทำรายการ 0 : Success / Completed

1 : Fail / In Completed 2 : Cancel 3 : Error 9 : Pending / Request (กรณชำระผานชองทาง Bill Payment)

2 status Number 20 คำอธบายผลของการทำรายการ 0 : Success / Completed 1 : Fail / In Completed 2 : Cancel 3 : Error 9 : Pending / Request (กรณชำระผานชองทาง Bill Payment)

3 transNo Number 20 เลขทอางองรายการสำหรบรานคา เลข Transaction Id เพอใชสำหรบตรวจสอบรายการอางองระหวางรานคา กบ ChillPay เชน 10071

4 orderNo String 20 เลขท Order หรอรหสอางองของรายการ

คาทไดรบมาจากรานคา

ตวอยาง ขอมลผลการชำระเงนทสงกลบไปใหทางหนาเวบไซตของรานคา (Method POST)

{ "transNo": 291453, "respCode": 0, "status": "Success", "orderNo": "132840206650" }

C H I L L P A Y – Specification Document Version 1.1.12

Page 22 of 46 For merchant only

Confidential

4. การตรวจสอบสถานะของรายการ กรณทรานคาไมไดรบขอมลทสงกลบจากระบบ ChillPay Gateway - URL สำหรบ POST ขอมลบน Sandbox : https://sandbox-appsrv2.chillpay.co/api/v2/PaymentStatus/

- URL สำหรบ POST ขอมลบน Production : https://appsrv.chillpay.co/api/v2/PaymentStatus/

ตารางท 4.1 : Request Parameter สำหรบสงคา POST ในการเรยก Check Payment Status API มายงระบบ ChillPay Gateway

No. Parameter Data Type

Length Mandatory / Optional

Description Remark

1 MerchantCode String 15 M Merchant ID. เปนคาทจะออกใหโดย ChillPay เชน M000001

2 TransactionId Number 20 M เลขทอางองรายการสำหรบรานคา (Transaction ID)

ดขอมลจากตารางท 3.1 ฟลดท 3

3 ApiKey String 60 M รหสอางองทใชในการเชอมตอระบบ

เปนคาทจะออกใหโดย ChillPay

4 CheckSum String 32 M ผลลพธทไดจากการนำคาทงหมดไปเขารหส MD5

ใชเพอยนยนความถกตองของรายการ

** หมายเหต **

- คา CheckSum เปนการนำคาจาก Parameter ตาง ๆ ตามตารางท 4.1 (ขอ 1 – 3) มาเรยงตอกน แลวตอทายดวย MD5 Secret Key (ทไดรบจากทาง ChillPay) ดงน MerchantCode+TransactionId+ApiKey+MD5 Secret Key จากนนนำขอมลทเรยงกนทงหมดนไปเขารหสดวยฟงกชน MD5 Hashing จงจะไดเปนคา “CheckSum”

- ใชคำสง URL Encode สำหรบขอมลดงตอไปน คอ ApiKey , MD5 Secret Key

C H I L L P A Y – Specification Document Version 1.1.12

Page 23 of 46 For merchant only

Confidential

ตวอยาง การเรยก Check Payment Status API Service (Code ภาษา PHP)

<?php $curl = curl_init(); curl_setopt_array($curl, array(

CURLOPT_URL => "https://sandbox-appsrv2.chillpay.co/api/v2/Payment/", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => "MerchantCode=XXXXX&ApiKey=112233445566778899001122334455667788990011223344556677889900&TransactionId=10078&CheckSum=9c1939c1fd2841fd7c2483df8f36be80", CURLOPT_HTTPHEADER => array(

"cache-control: no-cache", "content-type: application/x-www-form-urlencoded"

), )); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) {

echo "cURL Error #:" . $err; } else {

echo $response; }

C H I L L P A Y – Specification Document Version 1.1.12

Page 24 of 46 For merchant only

Confidential

ตารางท 4.2 : Response Parameter ทสงกลบไปให Server ของทางรานคา (JSON Format)

No. Parameter Data Type Length Description Remark 1 TransactionId Number 20 เลขทอางองรายการสำหรบ

รานคา เพอใชสำหรบตรวจสอบรายการอางองระหวางรานคา กบ ChillPay เชน 10071

2 Amount Number 12 จำนวนเงนทชำระของรายการ (2 หลกสดทายจะเปนคาทศนยม) *สกลเงน JPY และ KRW จะไม มหนวยทศนยม

ตวอยางเชน สงคาเขามาเปน 55025 ระบบจะอานคาเปน 550.25 สวนสกลเงน JPY และ KRW ระบบจะอานคาเปน 55025.00

3 OrderNo String 20 เลขท Order หรอรหสอางองของรายการ

คาทไดรบมาจากรานคา

4 CustomerId String 100 รหสอางองของลกคา(End User) หรอชอลกคา

คาทไดรบมาจากรานคา

5 BankCode String 20 รหสอางองแทนธนาคารทรบชำระ

เชน internetbank_bay ดรายละเอยดในภาคผนวก จ.

6 PaymentDate String 20 วนททำรายการชำระเงน Format: YYYYMMDDHHMMSS เชน 20170908125132

7 PaymentStatus Number 1 รหสผลการชำระเงนจากทางธนาคาร

อางอง ภาคผนวก ค.

8 BankRefCode String 50 รหสอางองรายการจากทางธนาคาร

เพอใชตรวจสอบรายการกบทางธนาคาร

9 CurrentDate String 10 วนทปจจบนททำการสงขอมล Format: YYYYMMDD เชน 20170908

10 CurrentTime String 10 เวลาปจจบนททำการสงขอมล Format: HHMMSS เชน 125132

11 PaymentDescription String 100 รายละเอยดสนคา หรอชอสนคา เชน สนคาไอโฟน X-XS 12 CreditCardToken String 100 ขอมล Token สำหรบการชำระ

เงนดวย Credit Card โดยทหนาเวบของ Credit Card จะทำการ auto fill ขอมลบตรใหเลยลกคาไมตองกรอกขอมลเอง

เชน “fexdff55efsd8e5fsd8e5sf4ds44fefasd6fsd8e1fs8fe1ws8d”

13 Currency String 3 ขอมลรหสสกลเงน เชน 764 ดรายละเอยดในภาคผนวก ฉ.

14 CustomerName String 50 ชอผชำระเงน เฉพาะชองทาง QR Payment 15 CheckSum String 32 ผลลพธทไดจากการนำคาทงหมด

ไปเขารหส MD5 ใชเพอยนยนความถกตองของรายการ

C H I L L P A Y – Specification Document Version 1.1.12

Page 25 of 46 For merchant only

Confidential

** หมายเหต **

- คา CheckSum เปนการนำคาจาก Parameter ตาง ๆ ตามตารางท 4.2 (ขอ 1 – 14) มาเรยงตอกน แลวตอทายดวย MD5 Secret Key (ทไดรบจากทาง ChillPay) ดงน TransactionId + Amount + OrderNo + CustomerId + BankCode + PaymentDate + PaymentStatus + BankRefCode + CurrentDate + CurrentTime + PaymentDescription + CreditCardToken + Currency + CustomerName + MD5 Secret Key จากนนนำขอมลทเรยงกนทงหมดนไปเขารหสดวยฟงกชน MD5 Hashing จงจะไดเปนคา “CheckSum”

- ใชคำสง URL Encode สำหรบขอมลดงตอไปน คอ ApiKey , MD5 Secret Key

ตวอยาง การนำขอมลมาเรยงตอกนเพอเขาฟงกชน MD5 999920000000001100001bank_qrcode20190125132533063684020190125132533Test Payment764นายแบงก มมากABCDEFGHJKMOPQRSTUVWXYZ

ตวอยาง ขอมลผลการชำระเงนท Return คากลบไปให Server ของทางรานคา จะอยในรปแบบ JSON Format

{ "TransactionId": 53, "Amount": 50000, "OrderNo": "00001", "CustomerId": "Test", "BankCode": "bank_qrcode", "PaymentDate": "20170908120814", "PaymentStatus": 0, "BankRefCode": "636406924946598613", "CurrentDate": "20170908", "CurrentTime": "125434", "PaymentDescription": "รายละเอยดการชำระเงน", "CreditCardToken": "", "Currency": "764", "CustomerName": "นายแบงก มมาก", "CheckSum": "55f09f04cb5562341d55e92e55a5e5e5"

}

C H I L L P A Y – Specification Document Version 1.1.12

Page 26 of 46 For merchant only

Confidential

5. ตวอยางหนาจอการชำระเงน

5.1 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Internet Banking

C H I L L P A Y – Specification Document Version 1.1.12

Page 27 of 46 For merchant only

Confidential

5.2 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Mobile Banking (K PLUS )

5.3 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Mobile Banking (SCB Easy App)

C H I L L P A Y – Specification Document Version 1.1.12

Page 28 of 46 For merchant only

Confidential

5.4 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Credit Card

5.5 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : QR Payment

C H I L L P A Y – Specification Document Version 1.1.12

Page 29 of 46 For merchant only

Confidential

5.6 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Bill Payment

5.7 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Alipay

C H I L L P A Y – Specification Document Version 1.1.12

Page 30 of 46 For merchant only

Confidential

5.8 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : WeChat Pay

5.9 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : True Money Wallet

C H I L L P A Y – Specification Document Version 1.1.12

Page 31 of 46 For merchant only

Confidential

5.10 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : ShopeePay

5.11 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Installment (KBANK)

C H I L L P A Y – Specification Document Version 1.1.12

Page 32 of 46 For merchant only

Confidential

5.12 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Installment (KTC FLEXI)

5.13 ตวอยางขนตอนการชำระเงนผานระบบ ChillPay : Pay with points (KTC FOREVER)

C H I L L P A Y – Specification Document Version 1.1.12

Page 33 of 46 For merchant only

Confidential

B. กรณรานคาตองการใชงานมากกวา 1 เวบไซต

กรณรานคาม Platform ในการใหบรการลกคาหลากหลายชองทาง เชน Website A, Website B, Mobile Application สามารถทำตามขนตอนไดดงน

1. รานคาแจงความประสงคขอเปด RouteNo เพม โดยแจงมาทอเมล [email protected] โดย 1 RouteNo เทากบ 1 Website

2. รานคาแกไข URL Background และ URL Result - URL สำหรบใชงาน : https://www.chillpay.co เลอกเมน Setting > Payment Channel โดยรานคาสามารถกำหนด URL

Background และ Result ของ Website A และ Website B ไดเอง จากนนกด -> บนทก - รานคาสามารถสลบเปนโหมดทดสอบ และโหมดใชงานจรงไดตามตวอยางรปดานลาง

3. วธการเชอมตอ 3 รปแบบ อางองจากขอ 6 หวขอการเชอมตอ สามารถทำได 3 วธ รานคาตองทำการแกไขขอมล RouteNo กอน POST ขอมลมาท ChillPay ตวอยางเชน รานคาตองการกำหนด Website B เปน RouteNo “2”

C H I L L P A Y – Specification Document Version 1.1.12

Page 34 of 46 For merchant only

Confidential

3.1 การเชอมตอแบบใช Code Template ใหรานคาทำการคดลอก(Copy) Code Template และเปลยนคา RouteNo เปน “2” กอน POST ขอมลกลบมาท ChillPay

C H I L L P A Y – Specification Document Version 1.1.12

Page 35 of 46 For merchant only

Confidential

3.2 การเชอมตอแบบใช HTML Form POST ขอมลมาท ChillPay ใหรานคากำหนด RouteNo" value="2" กอน POST ขอมลกลบมาท ChillPay

<!DOCTYPE html> <html><head> <meta charset="utf-8" /> <title>Payment</title> </head> <body>

<form id="form1" action="https://sandbox-cdnv3.chillpay.co/Payment/" method="post"> <input type="hidden" name="MerchantCode" value="XXXX"> <input type="hidden" name="OrderNo" value="00001"> <input type="hidden" name="CustomerId" value="00003"> <input type="hidden" name="Amount" value="20000">

<input type="hidden" name="PhoneNumber" value="0888889999"> <input type="hidden" name="Description" value="Test Payment"> <input type="hidden" name="ChannelCode" value="creditcard ">

<input type="hidden" name="Currency" value="764"> <input type="hidden" name="LangCode" value="TH">

<input type="hidden" name="RouteNo" value="2"> <input type="hidden" name="IPAddress" value="192.1.1.177">

<input type="hidden" name="APIKey" value="aaaabbbbccccddddeeeeffffgggghhhhkkkkaaaa"> <input name="TokenFlag" type="hidden" value="N">

<input name="CreditToken" type="hidden" value=""> <input name="CreditMonth" type="hidden" value="6"> <input name="ShopID" type="hidden" value=""> <input name="ProductImageUrl" type="hidden" value=""> <input name="CustEmail" type="hidden" value="">

<input type="hidden" name="CheckSum" value="55f09f04cb5562341d55e92e55a5e5e5"> </form>

</body></html>

C H I L L P A Y – Specification Document Version 1.1.12

Page 36 of 46 For merchant only

Confidential

3.3 การเชอมตอแบบ API รานคากำหนด RouteNo=2 กอน POST ขอมลกลบมาท ChillPay

<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://sandbox-appsrv2.chillpay.co/api/v2/Payment/', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => "MerchantCode=XXXXX&OrderNo=00001&CustomerId=100001&Amount=25000&PhoneNumber=0890000000&Description=Test-Payment&ChannelCode=internetbank_bay&Currency=764&LangCode=TH&RouteNo=2&IPAddress=127.0.0.1&APIKey=ZZZZZZZZZZZZZZZZ&[email protected]&CheckSum=4048167757bc0f670c9612af8d2677d5", CURLOPT_HTTPHEADER => array( "Cache-Control: no-cache", "Content-Type: application/x-www-form-urlencoded" ), )); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; }

C H I L L P A Y – Specification Document Version 1.1.12

Page 37 of 46 For merchant only

Confidential

4. เรยกดรายงาน ChillPay ตาม RouteNo รานคาสามารถเรยกดรายงาน ชองทาง Website A, Website B ไดจากการ -> เลอก Route No. ทตองการ จากนนกด -> Search

C H I L L P A Y – Specification Document Version 1.1.12

Page 38 of 46 For merchant only

Confidential

C. ขอมลการทดสอบบน Sandbox

ขอมลหมายเลขบตรเครดต สำหรบทดสอบบน Sandbox หมายเลขบตรเครดต - สำหรบทดสอบ Credit Card, Installment, Pay with points 1. Visa Card Number : 4444-4444-4444-4444 Expired Date : 09/2022 CVV2 : 123 2. Master Card Card Number : 3333-3333-3333-3333 Expired Date : 09/2022 CVV2 : 123 3. JCB Card Number : 2222-2222-2222-2222 Expired Date : 09/2022 CVV2 : 123

ขอมล Internet Banking สำหรบทดสอบบน Sandbox Internet Banking – ทกธนาคาร Username : demo01 Password : 1234 OTP Pass : 123456

ขอมล True Money Wallet สำหรบทดสอบบน Sandbox True Money Wallet เบอรโทรศพท : 0070000020 ใชสำหรบทดสอบจำนวนเงนคงเหลอในบญช เปน 0 บาท เบอรโทรศพท : 0008683501 ใชสำหรบทดสอบชำระเงนสำเรจ OTP Pass : 1 1 1 1 1 1 Remark: หากใสเบอรโทรศพทอน จะมผลใหไมพบขอมลในระบบ

C H I L L P A Y – Specification Document Version 1.1.12

Page 39 of 46 For merchant only

Confidential

ขนตอนทดสอบ Mobile Banking สำหรบทดสอบบน Sandbox Mobile Banking - KPLUS 1. แจงเบอรทตองการใชทดสอบกบเจาหนาททาง LINE Official หรอ เซลลผดแล 2. เจาหนาทจะสราง Link สำหรบทดสอบ ดวยเบอรทแจงมา สงใหรานคา 3. เปด Link ทเจาหนาทสงให เพอทดสอบชำระเงน 4. ทดสอบทำรายการดวยเบอรทรานคาแจงมา

ขนตอนทดสอบ QR Payment, Bill Payment, ShopeePay และ SCB Easy App สำหรบทดสอบบน Sandbox QR Payment, Bill Payment, ShopeePay และ SCB Easy App 1. รานคาสามารถดาวนโหลด และตดตงแอพพลเคชนสำหรบทดสอบไดท https://www.chillpay.co/Home/UserManual 2. ทดสอบทำรายการดวย QR Payment, Bill Payment, ShopeePay หรอ SCB Easy App 3. เปดแอพพลเคชน เพอทดสอบชำระเงน

ขนตอนทดสอบ Alipay และ WeChat Pay สำหรบทดสอบบน Sandbox Alipay และ WeChat Pay 1. แจงเจาหนาททาง LINE Official เพอนดหมายวนและเวลาในการทดสอบ 2. เมอถงเวลานดหมาย ใหรานคาเรมทำการทดสอบชำระเงน 3. แจงเลขททำรายการ (Transaction ID) จากหนาเวบชวเพยแกเจาหนาท เพอทำการยนยนรายการ 4. ตรวจสอบรายการทดสอบชำระเงนบนหนาเวบชวเพย

C H I L L P A Y – Specification Document Version 1.1.12

Page 40 of 46 For merchant only

Confidential

D. ภาคผนวก

ภาคผนวก ก. รหสผลของการทำรายการ ลำดบท 1

Response Code Description Remark 0 ทำรายการสำเรจ Success 1 ทำรายการไมสำเรจ Fail 2 รายการเกดขอผดพลาด Error 3 ระบบเกดขอผดพลาด ไมสามารถทำงานได System Error

ภาคผนวก ข. รหสผลของการทำรายการ ลำดบท 2

Response Code Description Remark 200 ทำรายการสำเรจ Success 1001 ขอมลพารามเตอรไมถกตอง Invalid Parameter 1002 รหสรานคาไมถกตอง Invalid Merchant Code 1003 API Key ไมถกตอง Invalid API Key 1004 Bank Channel Code ไมถกตอง Invalid Channel ID 1005 Route No. ไมถกตอง Invalid Route No 1006 Order Number ไมถกตอง Invalid Order No 1007 จำนวนเงนไมถกตอง Invalid Amount 1008 Customer ID/Customer Name ไมถกตอง Invalid Customer ID 1009 เบอรโทรศพทมอถอไมถกตอง Invalid Mobile Phone Number 1010 รหสภาษาไมถกตอง Invalid Language Code 1011 รหส Checksum ไมถกตอง Invalid Checksum 1012 เลขทอางองรายการ(Transaction ID) ไมถกตอง Invalid Transaction ID 1013 รายละเอยดการชำระเงนไมถกตอง Invalid Description 1014 ขอมล Token Flag ไมถกตอง Invalid Token Flag 1015 ขอมลรหสสกลเงนไมถกตอง Invalid Currency Code 1016 ขอมล Credit Card Token ไมถกตอง Invalid Credit Card Token 1017 ขอมลเดอนทผอนชำระไมถกตอง Invalid Installment Month 1018 ขอมล IP Address ไมถกตอง Invalid IP Address 1019 ขอมล Shop ID ไมถกตอง Invalid Shop ID 1020 ขอมล URL ของรปภาพสนคาไมถกตอง Invalid Product Image URL 2001 Account ของรานคายงไมไดรบการอนมต Account Unauthorized

C H I L L P A Y – Specification Document Version 1.1.12

Page 41 of 46 For merchant only

Confidential

2002 API Key รานคายงไมไดรบการอนมต Invalid Merchant API Key 2003 ขอมล Checksum ไมถกตอง Invalid Checksum Data 2004 ไมพบขอมลชองทางการชำระเงนสำหรบรานคา Invalid Merchant Routing 2005 จำนวนเงนทชำระนอยกวาจำนวนเงนขนตำสดทกำหนดไว Payment minimum price {0} less than {1}

เชน Payment minimum price 15.00 less than 20.00

2006 จำนวนเงนทชำระมากกวาจำนวนเงนขนสงสดทกำหนดไว Payment maximum price {0} is over than {1} เชน Payment maximum price 55000.00 is over than 50000.00

2007 ไมสามารถสรางรายการรบชำระเงนได Request Transaction Error 2008 ไมสามารถสรางรายการ Token รบชำระเงนได Request Transaction Token Error 2009 ไมพบขอมลรายการทตองการ Transaction Not Found 2010 ไมพบขอมล Credit Card Token ทใชชำระเงน Credit Card Token Not Found 2011 ไมพบขอมลรหสสกลเงนทใชชำระเงน Currency Code Not Supported 2012 ไมพบขอมลเดอนทใชผอนชำระ Installment Month Not Found 2013 เบอรโทรศพทมอถอทลงทะเบยนไวกบ K PLUS ไมถกตอง Mobile Phone No. not registered with

K PLUS Mobile Application. 2014 ไมพบ Email หรอรปแบบ Email ไมถกตอง Invalid/Incorrect email address. 3001 ระบบเกดขอผดพลาดไมสามารถทำรายการได System Error 3002 ระบบไมสามารถใหบรการไดในชวงเวลา xx:xx:xx –

xx:xx:xx กรณาทำรายการเขามาใหมอกครง System is unavailable at xx:xx:xx – xx:xx:xx o'clock. Please try again later.

C H I L L P A Y – Specification Document Version 1.1.12

Page 42 of 46 For merchant only

Confidential

ภาคผนวก ค. รหสผลของการชำระเงนของลกคา (ขอมลการชำระเงนจากทางธนาคาร)

Response Code Description Remark 0 ทำรายการชำระเงนสำเรจ Success 1 ทำรายการชำระเงนไมสำเรจ Fail 2 ลกคายกเลกทำรายการชำระเงน Cancel 3 เกดขอผดพลาดระหวางทำรายการชำระเงน Error 9 รอการชำระคาสนคา/บรการ Transaction Pending 20 ทำรายการ Void สำเรจ Void Success 21 ทำรายการ Refund สำเรจ Refund Success 22 ทำรายการเพอขอ Refund Request to Refund 23 ทำรายการโอนเงนใหรานคาสำเรจ Settlement Success 24 ทำรายการ Void ไมสำเรจ Void Fail 25 ทำรายการ Refund ไมสำเรจ Refund Fail

ภาคผนวก ง. รหสผลของการทำรายการสงขอมลกลบไปใหรานคา

Response Code Description Remark 200 ทำการสงขอมลสำเรจ Success 402 ไมไดกำหนดสทธใหเขาใชงานหนาเวบไซต Unauthorized 403 ไมอนญาตใหเขาใชงานหนาเวบไซต Forbidden 404 ไมพบหนาเวบไซต Not Found 405 พบปญหาระหวางการเรยกใชงานหนาเวบไซต Bad Request 500 เกดขอผดพลาดกบเซฟเวอร Server Error 502 เกด Timeout ระหวางทำการเรยกหนาเวบไซต Server Timeout

C H I L L P A Y – Specification Document Version 1.1.12

Page 43 of 46 For merchant only

Confidential

ภาคผนวก จ. รหสอางองแทนชองทางการรบชำระเงนตาง ๆ

No. Group type Code Remark 1 Internet Banking internetbank_bay ชองทางชำระเงนผาน ธนาคารกรงศร (BAY) 2 internetbank_bbl ชองทางชำระเงนผาน ธนาคารกรงเทพ (BBL) 3 internetbank_scb ชองทางชำระเงนผาน ธนาคารไทยพาณชย (SCB) 4 internetbank_ktb ชองทางชำระเงนผาน ธนาคารกรงไทย (KTB) 5 internetbank_ttb ชองทางชำระเงนผาน ธนาคารทหารไทยธนชาต (TTB) 6 Mobile Banking payplus_kbank ชองทางชำระเงนผาน K-PLUS (Mobile Banking ของ ธ.กสกร

ไทย) 7 mobilebank_scb ชองทางชำระเงนผาน SCB Easy App (Mobile Banking ของ

ธ.ไทยพาณชย) 8 Credit Card creditcard ชองทางชำระเงนผาน บตรเครดต Visa, Master Card, JCB,

CUP(China Union Pay) 9 e – Wallet epayment_alipay ชองทางชำระเงนผาน Alipay 10 epayment_wechatpay ชองทางชำระเงนผาน WeChat Pay 11 epayment_linepay ชองทางชำระเงนผาน Rabbit LINE Pay 12 epayment_truemoney ชองทางชำระเงนผานทรมนน วอลเลท 13 epayment_shopeepay ชองทางชำระเงนผาน ShopeePay 14 QR Payment bank_qrcode ชองทางชำระเงนผาน QR Code Payment 15 Bill Payment billpayment_cenpay ชองทางชำระเงนผาน Bill Payment (CenPay) 16 billpayment_bigc ชองทางชำระเงนผาน Bill Payment (Big C) 17 Installment Installment_kbank ชองทางชำระเงนแบบผอนชำระผานธนาคารกสกรไทย 18 installment_ktc_flexi ชองทางชำระเงนแบบผอนชำระผาน KTC FLEXI 19 Kiosk machine billpayment_boonterm ชองทางชำระเงนผาน ตบญเตม 20 Pay with points point_ktc_forever ชองทางชำระเงนแบบใชคะแนนสะสมผาน KTC FOREVER

C H I L L P A Y – Specification Document Version 1.1.12

Page 44 of 46 For merchant only

Confidential

ภาคผนวก ฉ. รหสสกลเงน (Currency Code)

No. Code (ISO Code) Currency 1 764 THB - บาทไทย 2 840 USD - ดอลลารสหรฐ 3 978 EUR - ยโร 4 392 JPY - เยนญปน 5 826 GBP - ปอนดสเตอรลง (สหราชอาณาจกร) 6 036 AUD - ดอลลารออสเตรเลย 7 554 NZD - ดอลลารนวซแลนด 8 344 HKD - ดอลลารฮองกง 9 702 SGD - ดอลลารสงคโปร 10 756 CHF - ฟรงกสวส

ภาคผนวก ช. รายละเอยด SSL

SSL หรอ Secure Socket Layer คอ Protocol ซงใชสำหรบการรบสงขอมลผานระบบ Internet โดยจะทำการเขารหสขอมลเพอ

ปองกนการดกจบขอมลทเปนความลบ ขอมลจะถกเขารหสและแปลงคาเปนตวเลขตาง ๆ ซงไมสามารถนำไปใชไดถาไมมการถอดรหสทถกตอง สำหรบรานคาทตองการรบผลการชำระเงนททาง ChillPay ตอบกลบแบบ Real Time นน SSL จงเปนสงททางรานคาจำเปนทจะตองมเพอปองกนปญหาการดกจบขอมลทเปนความลบ และอาจนำไปสการจารกรรมขอมลตาง ๆ ได

ในกรณทรานคาตองการทราบผลของการชำระเงนแบบ Real Time จะตองม SSL ทออกโดย Trusted Certification Authorities (e.g. VeriSign, Entrust) ขนตำ 128 bits (TLS 1.1, TLS 1.2)

ตวอยางรายชอผใหบรการ SSL

ทางรานคาสามารถศกษาขอมลเกยวกบ SSL คออะไร และมประโยชยอยางไร ไดจากผใหบรการตามรายชอตวอยาง ดงตอไปน

1. VeriSign https://www.verisign.com/ 2. Digicert https://www.digicert.com/ 3. Geotrust https://www.geotrust.com/ 4. Trustico https://www.trustico.com/ 5. SSL Certificates https://www.sslcertificate.com/

C H I L L P A Y – Specification Document Version 1.1.12

Page 45 of 46 For merchant only

Confidential

ภาคผนวก ซ. ตวอยางการพฒนา Android Application โดยใช WebView

วธการแกปญหา กรณ WebView เรยก Application ภายนอกไมได การพฒนา Android Application ดวย WebView แตไมสามารถเปด Application ภายนอกได สามารถทำไดโดย Function shouldOverrideUrlLoading เพอจดการ Prefix ของ Deep Link ตามตวอยาง

C H I L L P A Y – Specification Document Version 1.1.12

Page 46 of 46 For merchant only

Confidential

ตวอยาง Prefix Deep Link สำหรบ Production

ตวอยาง Prefix Deep Link สำหรบ Sandbox