Merchant Integration Guide - old.nrru.ac.th · สารบัญ ประวัติการแก้ไข 1 1. บทน า 2 2. การส่งขอ้มูลและรูปแบบของขอ้มูลที่ตอ้งส่งเขา้มาเพอื่ขอทารายการ

PAYSBUY

Merchant Integrations manual (API)

คมอการเชอมตอระบบช าระเงน

ส าหรบรานคาสมาชก แบบ API

เวอรช น 3.06

(แกไขลาสด 15/06/2013)

© 2010 PaySbuy Co. Ltd. All rights reserved. PAYSBUY is a registered trademark of PaySbuy Co. Ltd. The PaySbuy logo is a trademark of PaySbuy Co. Ltd. Other trademarks and brands are the property of their respective owners. The information in this document belongs to PaySbuy Co. Ltd. It may not be used, reproduced or disclosed without the written approval of PaySbuy Co. Ltd.

สารบญ

ประวตการแกไข 1 1. บทน า 2

2. การสงขอมลและรปแบบของขอมลทตองสงเขามาเพอขอท ารายการ PAYNOW 3

3.การก าหนดหนาการช าระเงนพนฐาน 5

4. การสงคาเพอรบช าระเงนจากบญช PayPal 6

5. การสงคาเพอสงคอมมชช นใหบญช PAYSBUY 7

6. การตรวจสอบความถกตองของขอมล 7

7. การตรวจสอบขอมลและการสงขอมลแบบ GET เพอขอท ารายการ 8

8. การตรวจสอบขอมลและการสงขอมลแบบ GET เพอขอท ารายการในรปแบบ iframe 10

9. การรบคาผลการช าระเงนจาก PAYSBUY 12

10. การท ารายการส าเรจหรอยกเลกการท ารายการ 13

11. การรบคาผลการช าระเงนดวยชองทางเงนสด 14

12. สาเหตการไมไดรบคาจากระบบเพยสบาย 15

13. ท าอยางไรเมอไมไดรบคาจากทาง PAYSBUY 15

14. แสดงโลโกรานคาทหนา PAYNOW 16

15. ตวอยางการรบคาในภาษาตางๆ 18

API Merchant Integration Manual Version 3.06

api_merchant_integration_manual_v3_th Confidential Page 1

ประวตการแกไข

วนท เวอรชน รายละเอยด

1 กนยายน 2553 3.01 - เพมการรบสงขอมลการช าระเงน

- เพมรายละเอยดการช าระเงนแบบเคานเตอรเซอรวส

- เพมโคดตวอยางการรบคากลบจากเพยสบาย

- เพม Appendix 1และ Appendix 2 ซงเปนเวบเซอรวสทจะชวย

รานคาตรวจสอบขอมลตางๆกบทางเพยสบาย

10 กนยายน 2553 3.02 - ยกเลกการสงคา secureCode หลงจากได refid

26 ตลาคม 2553 3.03 - เพมความยาวการสงขอมลของ resp_front_url และ resp_back_url

- เพมความยาวการสงขอมลของ opt_address

- แกไขการระบความหมายของ securecode

1 กนยายน 2554 3.04 - รองรบระบบโทรศพทมอถอ

- เพมระบบการรบช าระเงนในรปแบบ iframe

1 เมษายน 2556 3.05 - เปลยนชองทางการช าระเงนดวยเคานเตอรเซอรวสเปนเงนสด

- ปรบรปภาพหนาการช าระเงนดวยมอถอและเงนสด

15 พฤษภาคม 2556 3.06 - เพมชองทางการช าระเงน Tesco Lotus

- เพมพารามเตอร opt_param เพอก าหนดวนหมดอายของ Counter

Service, Tesco Lotus

- แกไขสกลเงน PayPal สามารถใชสกลเงนอน ๆ ได

- เปลยน method จาก api_paynow_authentication_new เปน

api_paynow_authentication_v3



1. บทน า

ระบบเพยสบายเปนผใหบรการตวกลางการช าระเงนระหวางรานคาและผซอ โดยเฉพาะผทเปนรานคานนจ าเปน

ทจะตองเขาใจขนตอนของการช าระเงนผานระบบของเพยสบาย ซงในคมอนจะเปนการอธบายถงขนตอนการท างาน

ทงหมดของทงฝงรานคาและฝงเพยสบาย โดยเรมจากรปกระบวนการท างานขางลางนจะอธบายกระบวนการท างาน

ทงหมดของระบบ

PAYSBUY API SYSTEM PROCESS V.3



2. การสงขอมลและรปแบบของขอมลทตองสงเขามาเพอขอท ารายการ PAYNOW

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

เซอรวสของทางเพยสบายเพอรองขอท ารายการ PAYNOW โดยมรายละเอยดดงน

Demo Server

https://demo.paysbuy.com/api_paynow/api_paynow.asmx

method : api_paynow_authentication_v3

Production server

https://www.paysbuy.com/api_paynow/api_paynow.asmx

method : api_paynow_authentication_v3

ระบขอมลตวแปรเขามาดงน

ตวแปร ชนดของขอมล สงคาวาง ตวอยางขอมล

psbID nchar(10) - “8303545188”

username nvarchar(200) - “[email protected]”

secureCode nvarchar(200) - “1586093a8f80cbb5003001b42f0eeb7c”

inv nvarchar(200) - “2009060101”

itm nvarchar(200) - “PAYSBUY Test Product”

amt double - 1

paypal_amt nvarchar(10) อนญาต “1”

curr_type nchar(2) - “TH”

com nvarchar(200) อนญาต “FbRy1+sLKnl4JpuwQ6D+sg==”

method nchar(1) - “1”

language nchar(1) - “T”

resp_front_url nvarchar(500) - “https://www.paysbuy.com/receiveresponse/Result.aspx”

resp_back_url nvarchar(500) - “https://www.paysbuy.com/receiveresponse/ResultReg.aspx”

opt_fix_redirect nchar(1) อนญาต “1”

opt_fix_method nchar(1) อนญาต “1”

opt_name nvarchar(200) อนญาต “PAYSBUY”

opt_email nvarchar(200) อนญาต “[email protected]”

opt_mobile nvarchar(200) อนญาต “0888888888“

opt_address nvarchar(500) อนญาต “PAYSBUY.COM”

opt_detail nvarchar(500) อนญาต “PAYMENT”

opt_param nvarchar(500) อนญาต “cash_exp=24&inst_display=y&device_display=m”

https://demo.paysbuy.com/api_paynow/api_paynow.asmx

https://www.paysbuy.com/api_paynow/api_paynow.asmx



อธบายความหมายของแตละตวแปร

ตวแปร ความหมายของขอมล

psbID หมายเลยประจ าตวของรานคา

username อเมลของรานคาหรอบคคลทวไปทใชในการรบเงน

secureCode รหสสวนตวของแตละอเมลของรานคาทเพยสบายก าหนดขนมาให

inv เลขทการสงซอสนคาหรอเลขทสนคา เปนตวทใชอางองระหวางระบบ PAYSBUY

และรานคาเพอตรวจสอบการท ารายการซงกนและกน

(resp_front_url, resp_back_url)

itm รายละเอยดการช าระเงน เชน รายละเอยดสนคา ชอสนคา รายละเอยดบรการ

amt จ านวนเงนรวมทตองการช าระ จ านวนตองมคาไมต ากวา 1

paypal_amt จ านวนเงนรวมทตองการช าระผาน PayPal จ านวนตองไมต ากวา 1 โดยช าระไดสกล

เดยวคอ USD (อานรายละเอยดเพมเตมไดทหนา 6)

curr_type สกลเงนทตองการช าระ คอ TH, US, AU, EU, GB, JP, NZ, HK, SG, CH ใชไดกบบตรเครดตเทานน (อานรายละเอยดเพมเตมไดทหนา 5)

com การระบการสงคาคอมมชชนใหกบบคคลอน ซงจะตองมการตดตอมาท PAYSBUY กอนเพอขอคาส าหรบตวแปรน

method แสดงชองทางการช าระเงนหลก

language ภาษาในหนาช าระเงน

resp_front_url URL ททาง PAYSBUY จะท าการเปลยนหนากลบไปพรอมทงสงผลการช าระเงนให

resp_back_url URL ททาง PAYSBUY จะท าการสงผลการช าระเงนใหทนททรผลการช าระเงน โดยไมมการเปลยนหนาสงขอมลแบบ background process

opt_fix_redirect การระบรปแบบการสงคากลบของ resp_front_url

หากระบคา 1 เขามาจะหมายถง ไมตองการใหมหนาสรปของ PAYSBUY ใหท าการกลบไปยง URL ทระบมาเลยทนททรผลการช าระเงน

หากไมระบคาเขามาจะหมายถงใหมหนาสรปผลการช าระเงนของ PAYSBUY กอน

แลวคอยมการเปลยนหนากลบไปยง URL ทระบมา

opt_fix_method ตองการใหแสดงหนาการช าระเงนชองทางเดยวหากระบคา 1 เขามาจะไมมชองทาง

อนใหเลอกโดยยดตามชองทางทสงมาพรอมกบตวแปร method

opt_name ชอของผช าระเงน

opt_email อเมลของผช าระเงน

opt_mobile เบอรโทรศพทของผช าระเงน

opt_address ทอยของผช าระเงน

opt_detail ขอความเพมเตมของผช าระเงน

opt_param

ตวแปร ประเภท รายละเอยด

cash_exp int ก าหนดระยะเวลากอนหมดอายของ Counter

Service, Testco Lotus โดยก าหนดเปน

cash_exp=24 คอ มระยะเวลาทสามารถช าระเงนไดไมเกน 24 ชม (ขนต า 6 ชม. ขน

ไป)

device_disp

lay

string(1) ก าหนดการแสดงผลเปน mobile version

device_display=m

inst_display string(1) ก าหนดการแสดงผลชองทางระบบผอนช าระ inst_display=y คอ ใหท าการแสดง

inst_display=n คอ ไมใหท าการแสดง

cp_code string(250) คปองโคดทรานคาสงมาเพอท าการขอช าระ

เงนตามทไดตกลงกนทางธรกจ



3. การก าหนดหนาการช าระเงนพนฐาน

PAYSBUY มชองทางการช าระเงนทสามารถระบใหเปนหนาการช าระเงนหลกไดดงน

ชองทาง การระบคา

บญชเพยสบาย 1

บตรเครดต 2

บญชเพยพาล 3

อเมรกน เอกซเพรส 4

ออนไลน แบงคกง 5

เงนสด 6

สมารทเพรส 8

การผอนช าระ 9

หากรานคายงไมไดรบการเปดบรการรบบตรเครดตหรอชองทางการช าระเงนอนๆ เมอมการเชอมตอกบระบบ

เพยสบายจะเหนชองทางการช าระเงนแบบ PAYSBUY เทาน น

หนาช าระเงนเพยสบายรองรบภาษาดงน

ภาษา พารามเตอร สถานะ

ไทย T เปดใชงาน

องกฤษ E เปดใชงาน

ญป น J เปดใชงาน

การต งคาสกลเงนตางประเทศและรปแบบการสงคา ทางรานคาสามารถตงราคาสนคาเปนสกลเงนตามตารางขางลางนเพอขอท าการตดเงนจากบตรเครดตของผช าระเงนเปน

สกลตามทรองขอ สวนชองทางอนๆ เชน บญชเพยสบาย เงนสด ออนไลนแบงคกง ไมสามารถใชได

ระบรหสสกลเงนมากบตวแปร curr_type ดงน

สกลเงนทแสดง ชอสกลเงน curr_type

THB Thai Baht TH

AUD Australian Dollar AU

GBP POUND STERLING GB

EUR EURO FR

HKD Hong Kong Dollar HK

JPY YEN (100) JP

NZD New Zealand Dollar NZ

SGD Singapore Dollar SG

CHF Swiss Franc CH

USD US Dollar US

แมวาทางรานคาจะท าการต งคาเปนเงนสกลตางๆ แตเงนทจะเขาสบญชรานคาจะถกแปลงเปนเงนบาทและ

ส าหรบรายการ AMEX เงนจะถกแปลงจากสกลอน มาเปนสกลบาทกอน แลวจงสงไปท ารายการตดเงนจาก

บตร AMEX

การทราบอตราแลกเปลยนท PAYSBUY ใชเพอไปก าหนดราคาสนคาทหนาเวบ *

PAYSBUY ม Web Service ทจะใหทานสามารถเรยกตรวจสอบอตราแลกเปลยนของ PAYSBUY

ไดท getCurrencyRate รายละเอยดเพมเตมทหนา 21 (Appendix 1)

*อตราแลกเปลยนของ PAYSBUY ใชอตราแลกเปลยนของ VISA และปรบคาผนผวนตามกฏของ VISA

ท าใหอตราแลกเปลยนของ PAYSBUY ไมสามารถเปรยบเทยบกบอตราแลกเปลยนของธนาคารทวไปได



4. การสงคาเพอรบช าระเงนจากบญช PayPal

PAYSBUY สามารถทจะใหทางรานคามชองทางในการรบเงนดวยบญช PayPal ได ซงทางรานคาจะตองมบญช

PayPal และน ามาผกเขากบระบบของ PAYSBUY กอน ตามขนตอนดงตอไปน

4.1 การตงคาเพอใหเพยสบายสามารถเรยกคา API ของทานได

4.2 ขนตอนการสรางป มรบช าระสนคา แบบม PayPal

สกลเงนทสามารถใชใน PayPal ได คอ THB, USD, AUD, EUR, GBP, JPN, NZD, HKD, SGD, CHF

การท ารายการผานชองทาง PayPal เงนจะเขาบญช PayPal เทาน น แตทานสามารถดประวตการท ารายการ

ของบญช PayPal ไดทหนาบญช PAYSBUY เมนยอย “บญช PayPal”

5. การสงคาเพอสงคอมมชช นใหบญช PAYSBUY

PAYSBUY มระบบการสงคาคอมมชชนใหกบบญช PAYSBUY อนได โดยสามารถสงใหได 1 บญช

โดยตองมการตกลงคาคอมมชชนกบทาง PAYSBUY กอนและเมอตกลงไดแลวทาง PAYSBUY จะสงรหสคอมมชชน

ใหกบทางรานคา เพอใชในการสงเขามาท ารายการแตละครง

ตวอยาง

ตองการสงคาคอมมชชนให บญช [email protected]

รหสคอมมชชนทเพยสบายสงใหกบทางรานคา คอ FbRy1+sLKnl4JpuwQ6D+sg==

https://www.paysbuy.com/faq_detail.aspx?faqID=155

https://www.paysbuy.com/faq_detail.aspx?faqID=156



6. การตรวจสอบความถกตองของขอมล

ถาการสงขอมลเขามาถกตองท งหมด จะสงขอมลกลบ ดงน

“006bbba67afdb5072dd795e422782a5c92” โดย

“00” คอ สถานะบอกวาการสงขอมลส าเรจ และ

“6bbba67afdb5072dd795e422782a5c92” คอ ขอมล reference id (refid) ทเพยสบายสงใหเมอมการสงขอมล

ส าเรจ

ถาการสงขอมลเขามาไมถกตอง จะตอบกลบขอมล ดงน

“90inv is null”

“91secureCode is incorrect”

“92PSBID or Email not found”

“93PSBID or Username incorrect”

Error Code Description

Error Code ค าอธบาย ตวอยางการตอบกลบ

90 สงขอมลไมครบถวน inv is null

91 รหส secureCode ไมถกตอง secureCode is incorrected

92 PSBID หรอ อเมล หรอ รหสผานไมถกตอง

PSBID or Email not found

93 รปแบบ PSBID หรอ อเมล ไม

ถกตอง หรอ รหสผานเปนขอมลวาง

PSBID or Username were

incorrected

หากทางรานคาไดรบขอมล ทไมใช “00” จะตองท าการสงขอมลเขามาใหมจนกวาจะไดขอมล

ทเปน “00” กลบไป เมอไดขอมลดงกลาวนกลบไปแลวรานคาจงสามารถท าในข นตอนถดไปได



7. การตรวจสอบขอมลและการสงขอมลแบบ GET เพอขอท ารายการ

เมอไดรบคา “00” และ refid แลว ขนตอนตอไปทางรานคาจะตองท าการเรยก URL เพอสงขอมลแบบ GET ไปยง

ระบบของทางเพยสบายโดยใสพารามเตอรทเปนขอมล refid ดงน

Demo Server

https://demo.paysbuy.com/paynow.aspx?refid=6bbba67afdb5072dd795e422782a5c92

refid = 6bbba67afdb5072dd795e422782a5c92 (example)

Production server

https://www.paysbuy.com/paynow.aspx?refid=0ff89de99d4a8f4b04cb162bcb5740cf

refid = 0ff89de99d4a8f4b04cb162bcb5740cf (example)

เมอสงขอมลเขามาแลวทางเพยสบายจะแสดงหนาการช าระเงน ตามขอมลทไดถกระบเขามา

หากสงขอมลเขามาเพอขอแสดงหนาช าระหลกเปนบญชเพยสบาย

https://demo.paysbuy.com/paynow.aspx?refid=6bbba67afdb5072dd795e422782a5c92

https://www.paysbuy.com/paynow.aspx?refid=0ff89de99d4a8f4b04cb162bcb5740cf



หากสงขอมลเขามาในเวอรช นโทรศพทมอถอ

หนาช าระเงนผานบญช PAYSBUY หนาช าระเงนผานบตรเครดต

หนาช าระเงนผานบญชธนาคาร หนาช าระเงนผานเงนสด



8. การตรวจสอบขอมลและการสงขอมลแบบ GET เพอขอท ารายการในรปแบบ iframe

เมอไดรบคา “00” และ refid แลว ขนตอนตอไปทางรานคาจะตองท าการเรยก URL เพอสงขอมลแบบ GET ไปยง

ระบบ iframe ของทางเพยสบายโดยใสพารามเตอรทเปนขอมล refid ดงน

Demo Server

https://demo.paysbuy.com/paynowiframe.aspx?refid=6bbba67afdb5072dd795e422782a5c92

refid = 6bbba67afdb5072dd795e422782a5c92 (example)

Production server

https://www.paysbuy.com/paynowiframe.aspx?refid=0ff89de99d4a8f4b04cb162bcb5740cf

refid = 0ff89de99d4a8f4b04cb162bcb5740cf (example)

เมอสงขอมลเขามาแลวทางเพยสบายจะแสดงหนาการช าระเงน ตามขอมลทไดถกระบเขามา

หากสงขอมลเขามาเพอของแสดงหนาช าระหลกเปนบญชเพยสบายในรปแบบ iframe

ตวอยางหนาช าระเงนผานบตรเครดตในรปแบบ iframe

https://demo.paysbuy.com/paynowiframe.aspx?refid=6bbba67afdb5072dd795e422782a5c92

https://www.paysbuy.com/paynowiframe.aspx?refid=0ff89de99d4a8f4b04cb162bcb5740cf



ตวอยางหนาช าระเงนผานบญชธนาคารในรปแบบ iframe

ตวอยางหนาช าระเงนผานเงนสดในรปแบบ iframe



9. การรบคาผลการช าระเงนจาก PAYSBUY

ในสวนของการรบคาจากเพยสบายเพอตรวจสอบผลการช าระเงน ซง PAYSBUY จะสงผลการช าระเงนกลบไปยง URL

ตามตวแปร resp_front_url และ resp_back_url โดยวธการ POST

resp_front_url หมายถงอะไร

เมอมรายการช าระเงนทงส าเรจและไมส าเรจ หากผช าระเงนกดป มสนสดการท ารายการ ระบบจะมการสงผลการ

ช าระเงนกลบไปใหรานคาพรอมกบมการเปลยนหนากลบไปยงหนารานคาตาม URL ทระบมาใน resp_front_url

resp_back_url หมายถงอะไร

เมอมรายการช าระเงนทงส าเรจและไมส าเรจ ระบบจะมการสงผลการช าระเงนกลบไปใหรานคาทนทททราบผล

การช าระเงนตาม URL ทระบมาใน resp_back_url โดยทผช าระเงนไมตองกดป มสนสดการท ารายการ (background

process)

ตวแปรทสงกลบและค าอธบาย (Parameters and Description)

ชอตวแปร ชนดตวแปร รายละเอยด

result Char ผลการช าระเงน

apCode Char รหสอนมตจากเพยสบาย

amt Char ยอดการช าระเงนของรายการ (เลขทศนยม 2 ต าแหนง)

fee Char คาธรรมเนยมการช าระเงน (เลขทศนยม 2 ต าแหนง)

method Char ชองทางการช าระเงน

ตวอยาง

ชอตวแปร รายละเอยด ตวอยาง

result ไมส าเรจ , 99 ตามดวยหมายเลข invoice No (xxxx) 99xxxx

ส าเรจ , 00 ตามดวยหมายเลข invoice No (xxxx) 00xxxx

อยระหวางด าเนนการ , 02 ตามดวยหมายเลข invoice

No (xxxx)

02xxxx

apCode PSB Approved Code 32593

amt ยอดการช าระเงนของรายการ (เลขทศนยม 2 ต าแหนง) 1000 หรอ 1000.00

fee คาธรรมเนยมการช าระเงน (เลขทศนยม 2 ต าแหนง) 4 หรอ 4.00

method 01 คอการช าระเงนดวย บญชเพยสบาย 01

02 คอการช าระเงนดวย บตรเครดต 02

03 คอการช าระเงนดวย บญชเพยพาล 03

04 คอการช าระเงนดวย อเมรกน เอกซเพรส 04

05 คอการช าระเงนดวย ออนไลน ไดเรกเดบต 05

06 คอการช าระเงนดวย เงนสด 06

08 คอการช าระเงนดวย สมารทเพรส 08

09 คอการช าระเงนดวย การผอนช าระ 09

ทกคร งเมอไดรบคากลบจากทาง PAYSBUY ใหรานคาท าการเรยกเวบเซอรวสของ PAYSBUY เพอตรวจสอบ

ความถกตองของคาทไดรบไปอกคร ง

ชอ method getTransactionByInvoice รายละเอยดเพมเตมทหนา 22 (Appendix 2) หรอ

method getTransactionByInvoiceCheckPost รายละเอยดเพมเตมทหนา 23 (Appendix 3)



10.การท ารายการส าเรจหรอยกเลกการท ารายการ

เมอผช าระเงนเขาสหนาของการช าระเงน และไดกรอกขอมลการช าระเงนเรยบรอยแลว ถงขนตอนการยนยนการช าระเงน

ผช าระเงนสามารถกดยนยนการช าระเงน หรอ ยกเลกการช าระเงนได

โดยจะแบงไดเปนกรณดงน

1. ยนยนการท ารายการแตรายการไมส าเรจ

2. ยนยนการท ารายการและรายการส าเรจ

1.เมอยนยนการท ารายแตรายการไมส าเรจ การทางเพยสบายจะมการสงขอมลแบบ POST กลบไปยงรานคา

โดยขอมลทสงกลบไปมดงน

ตวแปร ขอมล รายละเอยด

result “99”+”2009060101” “99” คอ การท ารายการไมส าเรจ

”2009060101” คอ inv ของรายการทท าไม

ส าเรจ

apCode “Insufficient Funds” รายละเอยดการท ารายการไมส าเรจ

amt “1” จ านวนเงนทท ารายการ

fee “0” คาธรรมเนยมของการท ารายการ

method “02” ประเภทการท ารายการ

01 = บญชเพยสบาย , 02 = บตรเครดต

2.เมอยนยนการท ารายการและส าเรจการ ทางเพยสบายจะมการสงขอมลแบบ POST กลบไปยงรานคา

โดยขอมลทสงกลบไปมดงน


result “00”+”2009060101” “00” คอ การท ารายการส าเรจ

”2009060101” คอ inv ของรายการทท าส าเรจ apCode “301001” ตวเลขบอกรายการทส าเรจ


fee “0.04” คาธรรมเนยมของการท ารายการ

method “02” ประเภทการท ารายการ

01 = บญชเพยสบาย , 02 = บตรเครดต

เพอความปลอดภยทมากขน ทางรานคาอาจจะตรวจสอบ URL และ IP ตองมาจากเพยสบายเทาน น



11. การรบคาผลการช าระเงนดวยชองทางเงนสด

การช าระเงน ณ จดบรการเคานเตอรจะมขนตอนทแตกตางจากการช าระเงนขนตอนอนๆ กลาวคอ เมอผท ารายการกรอก

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

ทางรานคาจะยงไมไดรบเงน

ทาง PAYSBUY จะมการสงผลการช าระเงนกลบไปบอกสถานะวา รอการช าระเงนอย

สงไปทง resp_front_url และ resp_back_url


result Char “02”+inv



fee Char 0.00

method Char 06

เมอผท ารายการช าระเงน ณ จดบรการเคานเตอร ทาง PAYSBUY จะสงผลการช าระเงนสดทายไปให

โดยตวแปรทสงยงเหมอนเดมและเพมตวแปร confirm_cs ไปใหดวย

สงไป resp_back_url อยางเดยว





fee Char คาธรรมเนยม

method Char 06

confirm_cs Char true, false



ส าหรบรายการทไมช าระเงน ณ จดบรการเคานเตอรเกนระยะเวลา 7 วน ทาง PAYSBUY จะมการสงขอมลกลบไปท

รานคาอกครงโดยตวแปร resp_back_url และสงคากลบจะเหมอนกนโดยท confirm_cs = false





fee Char คาธรรมเนยม

method Char 06

confirm_cs Char false

ถงขนตอนนจะตองเรยกเวบเซอรวส getTransactionByInvoice เพอตรวจสอบความถกตองอกครง

12.สาเหตการไมไดรบคาจากระบบเพยสบาย

การไมสงขอมล resp_front_url กลบจากระบบเพยสบาย

1. ผช าระเงนไมกดป มเพอกลบไปหนารานคาเมอ เพยสบายแสดงวาการท ารายการสนสดแลว

2. ผช าระเงนปดหนาจอขณะท ารายการ หรอ กอนสนสดท ารายการ

3. เกดปญหาจากระบบ ผช าระเงนไมสามารถท ารายการใดๆ ตอได

การไมสงขอมล resp_back_url กลบจากระบบเพยสบาย

1. ผช าระเงนไมกดป มเพอกลบไปหนารานคาเมอ เพยสบายแสดงวาการท ารายการสนสดแลว

2. เกดปญหาจากระบบ ผช าระเงนไมสามารถท ารายการใดๆ ตอได

13. ท าอยางไรเมอไมไดรบคาจากทาง PAYSBUY

PAYSBUY ม Web Service ทจะใหเรยกตรวจสอบรายการในกรณไมไดรบคากลบไปจาก PAYSBUY

ไดท getTransactionByInvoice รายละเอยดเพมเตมทหนา 22 (Appendix 2) หรอ

getTransactionByInvoiceCheckPost รายละเอยดเพมเตมทหนา 23 (Appendix 3)



14. แสดงโลโกรานคาทหนา PAYNOW ทางรานคาสามารถทจะน าโลโกรานคาตวเองแสดงในหนา PAYNOW ของ PAYSBUY ได

โดยท าการลอกอนท www.paysbuy.com และเขาทเมน ขอมลสวนตว และเลอก โลโกรานคา

รานคาสามารถอพโหลดไฟลรปภาพโลโกรานคาดวยขนาดรปไมเกน 228 x 105 pixel และไมเกน 200 KB และเมอมการช าระเงนโลโกของรานคาจะปรากฏทมมบนซายมอของหนา PAYNOW ทกครง

http://www.paysbuy.com/



ตวอยาง หนาช าระเงน



15. ตวอยางการรบคาในภาษาตางๆ

1) PHP

$result = $_POST["result"];

$result = substr($result, 0, 2);

$apCode = $_POST["apCode"];

$amt = $_POST["amt"];

$fee = $_POST["fee"];

$method = $_POST["method"];

$confirm_cs = strtolower(trim($_POST["confirm_cs"]));

/* status result

00=Success

99=Fail

02=Process

*/

if ($result == "00") {

if ($method == "06") {

if ($confirm_cs == "true") {

echo "Success";

} else if ($confirm_cs == "false") {

echo "Fail";

} else {

echo "Process";

}

} else {

echo "Success";

}

} else if ($result == "99") {

echo "Fail";

} else if ($result == "02") {

echo "Process";

} else {

echo "Error";

}



2) ASP

result = Request.Form(“result”);

result = mid(result, 1, 2);

apCode = Request.Form(“apCode”);

amt = Request.Form(“amt”);

fee = Request.Form(“fee”);

method = Request.Form(“method”);

confirm_cs = Request.Form(“confirm_cs”);

/* status result

00=Success

99=Fail

02=Process

*/

if (result == "00") {

if (method == "06") {

if (confirm_cs == "true") {

Response.Write("Success");

} else if (confirm_cs == "false") {

Response.Write("Fail");

} else {

Response.Write("Process");

}

} else {

Response.Write("Success");

}

} else if (result == "99") {

Response.Write("Fail");


Response.Write("Process");

} else {

Response.Write("Error");

}



3) JSP

หลงจากนนใหเรยกเวบเซอรวส getTransactionByInvoice เพอตรวจสอบความถกตองอกครง

รายละเอยดเพมเตมทหนา 22 (Appendix 2) หรอ getTransactionByInvoiceCheckPost รายละเอยดเพมเตม

ทหนา 23 (Appendix 3)

หากมขอสงสยในการเชอมตอระบบสามารถตดตอไดท บรษท เพยสบาย จ ากด เบอรโทร : 6621605463

result = Request.Form(“result”);

result = mid(result, 1, 2);

apCode = Request.Form(“apCode”);

amt = Request.Form(“amt”);

fee = Request.Form(“fee”);

method = Request.Form(“method”);

confirm_cs = Request.Form(“confirm_cs”);

/* status result

00=Success

99=Fail

02=Process

*/

if (result == "00") {

if (method == "06") {

if (confirm_cs == "true") {

out.println("Success");

} else if (confirm_cs == "false") {

out.println("Fail");

} else {

out.println("Process");

}

} else {

out.println("Success");

}


out.println("Fail");


out.println("Process");

} else {

out.println("Error");

}



Appendix 1

getCurrencyRate

ใชส าหรบการตรวจสอบอตราแลกเปลยนสกลเงนตางๆ

Demo Server

https://demo.paysbuy.com/psb_ws/getTransaction.asmx

method : getCurrencyRate

Production server

https://www.paysbuy.com/psb_ws/getTransaction.asmx

method : getCurrencyRate


ตวแปร ชนดของขอมล สงคาวาง รายละเอยด

psbID nvarchar(200) No หมายเลข PSBID

biz nvarchar(50) No อเมลของรานคา

secureCode nvarchar(50) No รหสทเพยสบายสรางขนมาใหส าหรบรานคาแตละราน

currency nvarchar(255) No อตราแลกเปลยนทตองการทราบ

ตวอยางการสงขอมล (Demo Server)

ตวแปร ขอมล

psbID “8303545188”

biz “[email protected]”

secureCode “1586093A8F80CBB5003001B42F0EEB7C”

currency “USA” (FRA, GBR, JPN, AUS, HKG, NZL, SGP, CHE)

ขอมลทสงกลบมาให มรายละเอยดดงน


result Boolean No True or False

Desc nvarchar(255) No “30.5555”





Appendix 2

getTransactionByInvoice

เนองจากปองกนปญหาการท ารายงานจาก Merchant แลวขอมลการช าระเงนจาก PAYSBUY ไมสงกลบไปให

Merchant ทาง Merchant สามารถเรยก Web Service เพอดขอมลการช าระเงนได โดยสามารถตง Cronjob รน

หลงจากท ารายการได ประมาณ 3-5 นาท หลงจากท ารายการ

Demo Server


method : getTransactionByInvoice

Production server


method : getTransactionByInvoice






invoice nvarchar(255) No เลขทการสงซอสนคาหรอเลขทสนคา



psbID “8303545188”



invoice “Q1yV/33”



result “00” , “99” 00 = รายการส าเรจ, 99 = รายการไมส าเรจ

”2009060101” คอ inv ของรายการทท าส าเรจ Invoice “Q1yV/33” เลขทการสงซอสนคาหรอเลขทสนคา

apCode “15345” , “000000” รหสรายการส าเรจของเพยสบาย , “000000” คอ ไมส าเรจ



method “02” ชองทางการช าระเงน





Appendix 3

getTransactionByInvoiceCheckPost

เนองจากการบางรายการของรานคาทมการช าระเงนไปแลวแตไมสามารถรบผลการช าระเงนจากทางเพยสบาย

ไดอนเนองมาจากสาเหตหลายอยางเชน เนตเวรดลม การสงคาไมสมบรณหรอปดหนาจอการช าระเงน เวบเซอรวสน

จะชวยตรวจสอบรายการทเกดปญหาเหลานนและสงผลการช าระเงนกลบไปยงรานคา โดยเพยสบายจะท าการ

ตรวจสอบทกๆ 5 นาทและท าการตรวจสอบไมเกน 5 ครง

Demo Server


method : getTransactionByInvoiceCheckPost

Production server


method : getTransactionByInvoiceCheckPost






invoice nvarchar(255) No เลขทการสงซอสนคาหรอเลขทสนคา

flag nvarchar(50) No ตวแปรทระบใหทางเพยสบายรวาเปน Front URL หรอ Back URL

ตวอยางเชน หากรานคาเรยกใชงานเวบเซอรวสนดวย

resp_front_url(postUrl) ใหระบคาเปน “F” เขามา



psbID “8303545188”



invoice “Q1yV/33”

flag “F” , “B”



result “00” , “99” 00 = รายการส าเรจ, 99 = รายการไมส าเรจ

”2009060101” คอ inv ของรายการทท าส าเรจ Invoice “Q1yV/33” เลขทการสงซอสนคาหรอเลขทสนคา

apCode “15345” , “000000” รหสรายการส าเรจของเพยสบาย , “000000” คอ ไมส าเรจ



method “02” ชองทางการช าระเงน



Documents