samsung pay web sample

แอพตัวอย่างเว็บ Samsung Pay

ตัวอย่างโครงการที่แสดงวิธีการรวม Samsung Pay กับ DataTrans

เริ่มต้น

Samsung Pay อนุญาตให้พ่อค้ารวบรวมการชำระเงินผ่านแพลตฟอร์มการชำระเงินของพวกเขาที่เชื่อมต่อ Samsung Pay Wallet และให้ผู้ใช้ตรวจสอบสิทธิ์ผ่านอุปกรณ์มือถือของพวกเขา ช่วยให้ผู้ค้าสามารถรับข้อมูลการชำระเงินที่เข้ารหัสซึ่งสามารถส่งต่อไปยังตัวประมวลผลการชำระเงินของพวกเขาสำหรับการอนุญาต คู่มือนี้มีไว้สำหรับพ่อค้าที่ต้องการรวม Samsung Pay กับ DataTrans สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเยี่ยมชม Samsung Pay: http://www.samsung.com/ch/samsung-pay/

Samsung Pay Flow

โซลูชัน samsungpay ทำจาก API สองตัว อันแรกเป็นเพียงเว็บสดีที่จะเรียกการชำระเงินบนเว็บ อันที่สองคือ API เซิร์ฟเวอร์ไปยังเซิร์ฟเวอร์ โฟลว์แอปพลิเคชัน/ ข้อความมีดังนี้:

1. ตอนแรกผู้ใช้คลิกที่ปุ่มจ่ายของพ่อค้า
2. ผู้ค้าได้สร้างธุรกรรมในระบบ Samsung การโทรนี้ส่งคืนข้อมูลการเข้ารหัสที่จำเป็นเพื่อส่งต่อไปยัง WebDK
3. ข้อมูลการเข้ารหัสจะถูกส่งต่อไปยัง SamsungPayWebsdk ซึ่งจัดการกับการเชื่อมต่อกับอุปกรณ์ผู้ใช้
4. ผู้ใช้จะถูกนำเสนอด้วยหน้าจอเข้าสู่ระบบสำหรับบัญชี Samsung ของเขา ทันทีที่เขาเข้าสู่ที่อยู่อีเมลหรือหมายเลขโทรศัพท์ของเขาและส่งการแจ้งเตือนแบบพุชจะถูกส่งไปยังอุปกรณ์ทั้งหมดที่เชื่อมโยงกับบัญชี Samsung ส่วนนี้ได้รับการจัดการทั้งหมดโดยโครงสร้างพื้นฐานของ Samsung
5. จากนั้นผู้ใช้ยอมรับคำขอชำระเงินบนอุปกรณ์มือถือของเขา
6. ทันทีที่ผู้ใช้ยอมรับคำขอการชำระเงินเซิร์ฟเวอร์ Samsungs จะตรวจสอบแล้วเรียกใช้ URL การโทรกลับ (กำหนดในขั้นตอนที่ 2) ด้วย referenceId
7. ผู้ค้าได้รับข้อมูลรับรองการชำระเงินจาก Samsung โดยโทรไปที่ SamsungPay API ด้วยรหัสอ้างอิง
8. ผู้ค้าส่งข้อมูลรับรองการชำระเงินไปยัง DataTrans เพื่อขออนุญาต
9. ผู้ค้าแจ้ง Samsung ว่าการทำธุรกรรมสำเร็จหรือไม่
10. ผู้ค้าแสดงหน้าจอยืนยัน

ข้อกำหนดเบื้องต้น

Samsung Pay เกี่ยวข้อง

1. Samsung Pay Dev-Account
2. บริการ Samsung Pay-id
3. อุปกรณ์เปิดใช้งาน Samsung Pay
4. รายการที่อยู่ IP/ ช่วงที่คุณต้องการได้รับการอนุญาตโดย Samsung เพื่อเข้าถึงระบบของพวกเขา (นักพัฒนา NAT, Dev Server, Production Server)

DataTrans เกี่ยวข้อง

1. DataTrans Merchant ID (รับที่นี่)
2. ผู้ค้าจะต้องกำหนดค่าให้ทำ XML-calls
3. ผู้ค้าจะต้องเปิดใช้งานสำหรับ Samsung Pay

ทั่วไป

1. ติดตั้ง Java ในระบบ dev ในพื้นที่ของคุณ
2. Maven ติดตั้งบนระบบ dev ในพื้นที่ของคุณ
3. OpenSSL ติดตั้งบนระบบ dev ของคุณ
4. เบราว์เซอร์ที่คุณต้องการ
5. ประสบการณ์พื้นฐานบางอย่างกับ Spring Boot
6. ความเข้าใจพื้นฐานบางอย่างเกี่ยวกับ Samsung Pay

การตั้งค่าผู้ค้า Samsung Pay

โปรดทราบว่าขั้นตอนเหล่านี้จะต้องใช้แอปพลิเคชันตัวอย่างเช่นเดียวกับหากคุณต้องการใช้ Samsung Pay ในสภาพแวดล้อมที่มีประสิทธิผลของคุณ ขั้นตอนเหล่านี้ต้องการให้คุณติดต่อกับ Samsung

ลงทะเบียนสำหรับบัญชี samsungpay dev

ไปที่ https://us-partner.pay.samsung.com/ และลงทะเบียน คุณสามารถใช้บัญชีนี้ในภายหลังเพื่อทดสอบบนอุปกรณ์ Samsung ของคุณ

การรับบริการ samsungpay-id

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

 - File extension CSR
- RSA Key Size 2048 bit or higher
- Signature Algorithm: Sha256WithRSAEncryption

สร้าง CSR หนึ่งรายการสำหรับสภาพแวดล้อมการทดสอบและการผลิตของคุณ

นอกจากนี้คุณต้องส่งรายการที่อยู่ IP ของคุณไปยัง Samsung ในระหว่างกระบวนการ onboarding กรุณาติดต่อสำหรับข้อมูลเพิ่มเติม ส่ง CSR แต่ละตัวไปยัง Samsung หลังจากตรวจสอบบัญชีของคุณที่อยู่ IP และ CSR ของคุณคุณจะได้รับบริการ ID และการเข้าถึงเอกสารของพวกเขา

วิธีสร้าง CSR

สร้างคีย์ส่วนตัวของคุณ

openssl genrsa -out domain.com.key 2048

สร้าง CSR ด้วยคีย์ส่วนตัวของคุณ

openssl req -out CSR.csr -key domain.com.key -new -sha256

ตรวจสอบ CSR ของคุณ

 openssl req -in CSR.csr -noout -text

แอปพลิเคชันตัวอย่าง

แอปพลิเคชันตัวอย่างคือแอปพลิเคชัน Spring Boot (https://projects.spring.io/spring-boot/) ที่สามารถหมดกล่อง มันใช้ Tomcat ที่ฝังตัว

การติดตั้ง

1. โคลนที่เก็บ

   $ git clone [email protected]:datatrans/samsungpay-web-sample.git
   $ cd samsungpay-web-sample

2. เปิดด้วยตัวแก้ไข IDE / TEXT ที่คุณชื่นชอบ
3. ติดตั้งโครงการ

 mvn clean install

การแปลงคีย์ส่วนตัวของคุณ

ในการถอดรหัสข้อมูลรับรองการชำระเงินที่ส่งโดย Samsung คุณต้องใช้คีย์ส่วนตัวของคุณในรูปแบบ DER นี่คือวิธีที่คุณแปลง

     openssl pkcs8 -topk8 -in domain.com.key -outform DER -nocrypt -out rsapriv.der

ทำสิ่งนี้สำหรับแต่ละคีย์ส่วนตัวในแต่ละสภาพแวดล้อม คัดลอกไฟล์ไปยัง src/main/resources

การปรับคุณสมบัติ

คุณสมบัติ	คำอธิบาย	ไฟล์
เซิร์ฟเวอร์พอร์ต	พอร์ตที่เซิร์ฟเวอร์ควรทำงานอยู่	Application.properties
การโทรกลับ	การโทรกลับ Samsung ใช้ ตรวจสอบให้แน่ใจว่านี่สอดคล้องกับพอร์ตเซิร์ฟเวอร์ของคุณ	Application.properties
Merchant.name	ชื่อ บริษัท ของคุณ	Application.properties
พ่อค้าอ้างอิง	สิ่งนี้ถูกใช้โดย Samsung เพื่อแสดงธุรกรรมในแอพ SamsungPay	Application.properties
samsung.serviceid	ServiceId ของคุณได้รับจาก Samsung	Application-Dev.Properties / Application-prod.properties
dataTrans.merchantId	dataTrans ของคุณ merchantid	Application-Dev.Properties / Application-prod.properties
datatrans.sign	สัญญาณที่เป็นของผู้ค้า	Application-Dev.Properties / Application-prod.properties

การทดสอบ

1. เปิด URL ที่คุณกำหนดไว้ในเบราว์เซอร์ของคุณ
2. เติมอินพุตและแตะ/คลิก "จ่ายด้วย samsungpay"
3. เข้าสู่ระบบด้วยบัญชี Samsung Dev-Account ของคุณ
4. ยืนยันธุรกรรมอุปกรณ์ของคุณ
5. ผลลัพธ์จะปรากฏขึ้น

ในระหว่างการติดต่อกับ Samsung คุณจะได้รับแอพ Samsung Pay ตัวอย่าง แอพจะมีบัตรทดสอบเหล่านั้นจะไม่ถูกเรียกเก็บเงินโดย DataTrans แต่จะถูกแทนที่หากมีการส่งโทเค็น Samsung จ่ายที่ถูกต้องดังนี้:

ถ้า

cardno = 4242 4242 4242 4242 expm = 12 expy = 18

การอนุญาตด้วย dataTrans

ตรวจสอบ src/main/java/ch/datatrans/examples/samsungpay/client/DatatransClient.java เพื่อดูว่าการอนุญาตเสร็จสิ้นอย่างไร

คำขอตัวอย่าง:

<? xml version = " 1.0 " encoding = " UTF-8 " ?>
< authorizationService version = " 1 " >
  < body merchantId = " $merchantId " >
    < transaction refno = " $refno " >
      < request >
        < samsungPayData > <![CDATA[ $token ]]> </ samsungPayData >
        < reqtype >NOA</ reqtype >
        < transtype >05</ transtype >
        < sign >$sign</ sign >
      </ request >
    </ transaction >
  </ body >
</ authorizationService >

การตอบสนองตัวอย่าง:

<? xml version = " 1.0 " encoding = " UTF-8 " ?>
< authorizationService version = " 1 " >
  < body merchantId = " $merchantId " status = " accepted " >
    < transaction refno = " $refno " trxStatus = " response " >
      < request >
        < samsungPayData > <![CDATA[ $token ]]> </ samsungPayData >
        < reqtype >NOA</ reqtype >
        < transtype >05</ transtype >
        < sign >$sign</ sign >
      </ request >
      < response >
        < responseCode >01</ responseCode >
        < responseMessage >Authorized</ responseMessage >
        < uppTransactionId >160823101329060450</ uppTrasactionId >
        < authorizationCode >538050451</ authorizationCode >
        < acqAuthorizationCode >101538</ acqAuthorizationCode >
        < aliasCC >70119122433810042</ aliasCC >
        < expy >18</ expy >
        < expm >12</ expm >
      </ response >
    </ transaction >
  </ body >
</ authorizationService >

การโทรที่ประสบความสำเร็จจะส่งคืนสถานะแอตทริบิวต์ของ <body> status="accepted" และ <transaction> ของ trxStatus="response" รวมถึงองค์ประกอบ <response> ใหม่ที่มี Responsecode Responsecode เท่ากับ "01" หรือ "02" หมายถึงธุรกรรมที่ได้รับอนุญาต Elements Aliascc, Expy และ Expm จะถูกส่งคืนเฉพาะในกรณีที่ผู้ค้าใช้นามแฝงบัตรเครดิต

ข้อสังเกต

• นี่คือรหัสตัวอย่าง! ไม่เคยใช้รหัสนี้ในการผลิต!
• หากคุณมีคำถามโปรดยกประเด็นและเพิ่มฉลาก "คำถาม"

ภาคผนวก

datatrans apis

สร้างขึ้นด้วย

• รองเท้าสปริง
• หนอง