Samsung Pay Web Checkout This page describes all guidance for the SamsungPay Web Checkout service. It is primarily aimed at partners that want to integrate with this service. This document includes onboarding processes, service flows, Web SDK and API call instructions, and other elements of the integration process. This document must not be distributed to others except for authorized partner members.
You can provide a SamsungPay option for payment to users on your web site. The user can then select the SamsungPay option to pay, and then a push message requesting payment arrives to the user’s device and the payment can be confirmed by user authentication. The generated payment cryptogram and data are passed to your system and finally bypassed to PG (Payment Gateway) and card network side for transaction approval.
SamsungPay
If the user accesses the merchant’s web site through a mobile web browser, the SamsungPay web SDK can detect this environment. In this case, the account binding process can be done at the device level because the web browser and SamsungPay application run on same device. You can see the detailed steps of device-level account binding in the following figures.
SamsungPay Web Checkout is designed to operate in the Samsung Internet and Google Chrome browsers. For Android apps which use WebView, you must invoke the SamsungPay InApp SDK, instead of using this Web Checkout SDK.
For onboarding as a new partner of the SamsungPay Web Checkout service, you need to provide the following information to the SamsungPay team so that they can register it at the admin portal. After registration, the SamsungPay team informs you of your Service ID. The Service ID is used to integrate with SamsungPay Web Checkout APIs and Web Checkout UI.
After doing this registration task, Samsung team gives you your service ID for the Web Checkout service. This Service ID is very important, because it is used for the whole Web Checkout service flow. The Samsung team provides two Service IDs, one for a development environment and the other for a production environment.
Firewall exception registration Initially, the Samsung team registers your servers’ and developers’ IP addresses in the development environment. Once the service integration between you and Samsung is completed in the development environment, your production server IPs are registered in the same way.
Testing the Web checkout API server connection After the firewall registration by the Samsung team, you need to test the server-to-server connection.
Calling the Web Checkout API for testing If the server-to-server connection is confirmed, you can call the Web Checkout APIs for testing purposes. With this testing, you are able to get the value of each field.
Development
```json POST https://api-ops.stg.mpay.samsung.com/ops/v1/transactions Content-Type:application/json { "callback": "https://merchant.host.endpoint/order/KjeNvldA64v91gaHa/result", "paymentDetails": { "service": { "id": "dcc1cbb25d6a470bb42926acfbe1210f" }, "orderNumber": "DSTRF345789dsgTY","protocol": { "type": "3DS", "version": "80" }, "amount": { "option": "FORMAT_TOTAL_ESTIMATED_AMOUNT", "currency": "USD", "total": 300 }, "merchant": { "name": "virtual shop", "url": "virtualshop.com", "reference": "xn7qfnd" }, "allowedBrands": [ "VI", "MC" ] } } ```
Production
POST https://api-ops.mpay.samsung.com/ops/v1/transactions Content-Type:application/json { "callback": "https://merchant.host.endpoint/order/KjeNvldA64v91gaHa/result", "paymentDetails": { "service": { "id": "dcc1cbb25d6a470bb42926acfbe1210f" }, "orderNumber": "DSTRF345789dsgTY","protocol": { "type": "3DS", "version": "80" }, "amount": { "option": "FORMAT_TOTAL_ESTIMATED_AMOUNT", "currency": "USD", "total": 300 }, "merchant": { "name": "virtual shop", "url": "virtualshop.com", "reference": "xn7qfnd" }, "allowedBrands": [ "VI", "MC" ] } }
If the call is successful, the following response is returned
{ "resultCode": "0", "resultMessage": "SUCCESS", "id": "59e30acf1eba4d998e646e", "href": "https://us-online.stg.mpay.samsung.com/onlinepay", "encInfo": { "mod": "f65146e3497b8f737d449d1cf428f878f", "exp": "10001", "keyId": "9a010e4f3d484c07bddb" } }
When the Samsung team sends you your Service ID, they also provide the Web Checkout SDK. This script file is used for opening the Web Checkout UI page. To learn more about the Web Checkout SDK, see the 6. Getting Started with the Web Checkout SDK section of this document.