Samsung Pay Native Integration

Introduction

Samsung Pay Native Integration allows you to accept payments directly from Samsung Pay without redirecting customers to external payment pages.
It provides a fast, secure, and native checkout experience within your mobile application or website by using the customer’s payment credentials stored in Samsung Wallet.
By integrating Samsung Pay natively, your customers can complete payments effortlessly using their Samsung device’s authentication methods, resulting in a smoother and more trusted checkout flow.

Integration Flow Steps

1. Initial Contact & CSR File Request

You will need to contact the MyFatoorah tech team to request a CSR (Certificate Signing Request) file.
Note: The CSR file will be used for generating the necessary certificates for Samsung Pay.

2. Generate Payment Processing Certificate (PPC)

Once you have a CSR file, they need to use it to generate the Payment Processing Certificate (PPC) with Samsung Pay.
This is an essential step to ensure that you can securely process payments using Samsung Pay.

3. Share PPC with MyFatoorah

After generating the PPC, you must send it back to the MyFatoorah tech team.
This allows MyFatoorah to install the certificate.

4. Installation and Confirmation

Once the PPC is received, MyFatoorah’s tech team will install the certificate on their server.
After successful installation, MyFatoorah tech team will confirm the installation with the vendor to complete the integration.

5. Start Using Samsung Pay Integration

After the confirmation from MyFatoorah, you can proceed with the next steps in the integration process:

Endpoint: POST /v3/payments

{
    "PaymentMethod": "SAMSUNG_PAY",
    "Order": {
        "Amount": 25
    },
    "SourceOfFund": { 
      "Token": "{\"method\":\"3DS\",\"recurring_payment\":false,\"card_brand\":\"visa\",\"card_last4digits\":\"1738\",\"3DS\":{\"type\":\"S\",\"version\":\"100\",\"data\":\"eyJhbGciOiJSU0ExXzUiLCJraWQiOiJpbTZnTk5ZaS9YZ3BWNTVMaWZkN3BBTkQ3VU9rb3BHRHhIcy9WSmJ5NytVPSIsInR5cCI6IkpPU0UiLCJjaGFubmVsU2VjdXJpdHlDb250ZXh0IjoiUlNBX1BLSSIsImVuYyI6IkExMjhHQ00ifQ.OhMqFJKaJEiOnbWOaZM5ZW39shG0RifMl3qjOwz8oetCjhKCMqsugh9u_T5Xbq8TLbmm5PUNuk0eGe4KBaE_9cQ4J3eaEP6V2fhWZlep_gwsJCZycvuNTLSfCGMcnkbEEOKMMxYiRMzcAskqbJzEUpDwmNLE5OPnUY9lnRStI3KakcMjMn-DCaBmKik9parv4mZeMniiqJnxXz39mWRsIEo5OF1B4OSMwLBsZIByfMgH3uGcT9oXdTvCPjI62uJ5ByR64pfMOCt1edZgM3cg0LJ-KqAhGM42uM4517rdQGh6BZcaAch9WCs34H_F8RtNUdZVKJp0nUEQAlHxW-dHOA.j8gt5xNXz6C008FJ.242zDcviTAB8EHRLc7oesQJ4YoqRLt3aeOaFjmYeopCFmWfZMXElFG-qrEYUrFCEeQ8FNU9_xM1Wc4MeBzMgUpGTFY7Nz--hZzFlfV1QelUlt0nvwS_-e7QWgadUZgEaWO7iyPC2vqUxezNjBP3hgrLiQP-9G9yZTItxu0hZDlw8ow5VurJOPjsYT5xzstMXik4W6T2dDEsO7_iS9tE6rs3Tr4wWC9CqVb4OPqBDekI2REi1dFjl65E.T7L9YdU1y0jMRXNlN7F_iA\"}}"
	}
}

{
    "IsSuccess": true,
    "Message": "",
    "ValidationErrors": null,
    "Data": {
        "InvoiceId": "6316950",
        "PaymentId": "07076316950317297473",
        "PaymentURL": "https://demo.MyFatoorah.com/En/KWT/PayInvoice/Result?paymentId=07076316950317297473",
        "PaymentCompleted": true,
        "TransactionDetails": {
            "Invoice": {
                "Id": "6316950",
                "Status": "PENDING",
                "Reference": "2025060692",
                "CreationDate": "2025-11-26T08:33:41.5559932Z",
                "ExpirationDate": "2026-05-25T08:33:41.5559932Z",
                "ExternalIdentifier": null,
                "UserDefinedField": "",
                "MetaData": null
            },
            "Transaction": {
                "Id": "07076316950317297473",
                "Status": "FAILED",
                "PaymentMethod": "Samsung Pay",
                "PaymentId": "07076316950317297473",
                "ReferenceId": "07076316950317297473",
                "TrackId": "26-11-2025_3172974",
                "AuthorizationId": "07076316950317297473",
                "TransactionDate": "2025-11-26T08:33:41.7557429Z",
                "ECI": "",
                "IP": {
                    "Address": "",
                    "Country": ""
                },
                "Error": {
                    "Code": "MF002",
                    "Message": "DECLINED : Invalid card number"
                },
                "Card": {
                    "NameOnCard": "",
                    "Number": "427106xxxxxx3952",
                    "PanHash": "fa6e018a4f6e01a4b05de343e4aefc3890117c63a68eaffaecd71c11ece52d13",
                    "ExpiryMonth": "12",
                    "ExpiryYear": "29",
                    "Brand": "Visa",
                    "Issuer": "",
                    "IssuerCountry": "",
                    "FundingMethod": ""
                }
            },
            "Customer": {
                "Reference": "",
                "Name": "Anonymous",
                "Mobile": "+965",
                "Email": ""
            },
            "Amount": {
                "BaseCurrency": "KWD",
                "ValueInBaseCurrency": "25",
                "ServiceCharge": "0.1",
                "ServiceChargeVAT": "0.015",
                "ReceivableAmount": "24.885",
                "DisplayCurrency": "KWD",
                "ValueInDisplayCurrency": "25",
                "PayCurrency": "KWD",
                "ValueInPayCurrency": "25"
            },
            "Suppliers": []
        }
    }
}