Samsung Pay Direct Integration

Overview

Samsung Pay Direct Integration allows you to process Samsung Pay payments by decrypting the Samsung Pay token on your side. After decrypting the token, you extract the card details provided by Samsung Pay and send them to MyFatoorah to process the payment.

How It Works

The payment is processed immediately without redirecting the customer for authentication. The payment result is returned directly in the same response.

Endpoint: POST /v3/payments(Create Payment)

{
    "PaymentMethod": "SAMSUNG_PAY",
    "Order": {
        "Amount": 20
    },
    "SourceOfFund": {
        "Card": {
            "Number": "5204240498885735",
            "ExpiryMonth": "06",
            "ExpiryYear": "26",
            "Cryptogram": "ALJJjhJSf8kZAmsy+VVBAoABFA==",
            "WalletProvider": "samsungpay"
        }
    },
    "IntegrationUrls": {
        "Redirection": "https://your-website.com/payment-callback"
    }
}

{
    "IsSuccess": true,
    "Message": "",
    "ValidationErrors": null,
    "Data": {
        "InvoiceId": "6389685",
        "PaymentId": "07076389685322474474",
        "PaymentURL": "https://your-website.com/payment-callback?paymentId=07076389685322474474&Id=07076389685322474474",
        "PaymentCompleted": true,
        "TransactionDetails": {
            "Invoice": {
                "Id": "6389685",
                "Status": "PENDING",
                "Reference": "2025001618",
                "CreationDate": "2025-12-24T16:35:59.7738109Z",
                "ExpirationDate": "2026-05-23T16:35:59.7738109Z",
                "ExternalIdentifier": null,
                "UserDefinedField": "",
                "MetaData": null
            },
            "Transaction": {
                "Id": "07076389685322474474",
                "Status": "FAILED",
                "PaymentMethod": "Samsung Pay",
                "PaymentId": "07076389685322474474",
                "ReferenceId": "07076389685322474474",
                "TrackId": "24-12-2025_3224744",
                "AuthorizationId": "07076389685322474474",
                "TransactionDate": "2025-12-24T16:35:59.8202131Z",
                "ECI": "",
                "IP": {
                    "Address": "",
                    "Country": ""
                },
                "Error": {
                    "Code": "MF002",
                    "Message": "DECLINED : Invalid card number"
                },
                "Card": {
                    "NameOnCard": "",
                    "Number": "520424xxxxxx5735",
                    "Token": "",
                    "PanHash": "98899f423ac13b6dbdc3ef62b275ece6e37d60f73b0c6894379b9c48d847c2ff",
                    "ExpiryMonth": "06",
                    "ExpiryYear": "26",
                    "Brand": "",
                    "Issuer": "",
                    "IssuerCountry": "",
                    "FundingMethod": ""
                }
            },
            "Customer": {
                "Reference": "",
                "Name": "Anonymous",
                "Mobile": "+965",
                "Email": ""
            },
            "Amount": {
                "BaseCurrency": "KWD",
                "ValueInBaseCurrency": "20",
                "ServiceCharge": "0.22",
                "ServiceChargeVAT": "0.033",
                "ReceivableAmount": "19.747",
                "DisplayCurrency": "KWD",
                "ValueInDisplayCurrency": "20",
                "PayCurrency": "SAR",
                "ValueInPayCurrency": "247.02"
            },
            "Suppliers": []
        }
    }
}