Apple Pay Native Integration

Introduction

Apple Pay Native Integration allows you to accept payments directly from Apple 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 Apple Wallet.
By integrating Apple Pay natively, your customers can complete payments using Face ID or Touch ID, improving both conversion rates and user trust.

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 Apple 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 Apple Pay.
This is an essential step to ensure that you can securely process payments using Apple Pay.

📘
Steps for Payment Processing Certificate Generation
https://developer.apple.com/help/account/capabilities/configure-apple-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 Apple Pay Integration

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

Endpoint: POST /v3/payments

{
    "PaymentMethod": "APPLE_PAY",
    "SourceOfFund": {
        "Token": "{\"PaymentData\":{\"version\":\"EC_v1\",\"data\":\"FY54AajfqpMCGOrXK0AePw8\/kxVVRMn\/hL7O0Yu1+j6nrSrJGSeUtVaDDJkvV9Nht+szczce3aWGk4CpZKWgZtFxMHWW4m8eMD2Ciq1S21ds451hQ1GhIaVJ+KZRdb0rTa39q3U5zSxb5ZyxJ6PcgAbn9UVLuy3rZvtN7WiCeh15GTMKsQA1Kky8M0Pan112xBWiOw\/7R+Lus68ADkBRMbe1UG8\/E8inocrk1Lym+nOuB9e44kQE6Z0c7ZjjK1fGG2ew+YHq1stk1bsAOOvIhjMmdAJLL1d0dsqjCqPIZv9MMDwUZRtfuUAFxn\/92lYm4WBJ22kaIBeGk\/fTx6fTFIuOxCgRA+yIdBIILF8NKXWG\/9zA5BMufojlC8WBb0T8K1OWN4eswk7y5jg\/6tQ=\",\"signature\":\"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\/S5LMA8GA1UdEwEB\/wQFMAMBAf8wHwYDVR0jBBgwFoAUu7DeoVgziJqkipnevr3rr9rLJKswNwYDVR0fBDAwLjAsoCqgKIYmaHR0cDovL2NybC5hcHBsZS5jb20vYXBwbGVyb290Y2FnMy5jcmwwDgYDVR0PAQH\/BAQDAgEGMBAGCiqGSIb3Y2QGAg4EAgUAMAoGCCqGSM49BAMCA2cAMGQCMDrPcoNRFpmxhvs1w1bKYr\/0F+3ZD3VNoo6+8ZyBXkK3ifiY95tZn5jVQQ2PnenC\/gIwMi3VRCGwowV3bF3zODuQZ\/0XfCwhbZZPxnJpghJvVPh6fRuZy5sJiSFhBpkPCZIdAAAxggGIMIIBhAIBATCBhjB6MS4wLAYDVQQDDCVBcHBsZSBBcHBsaWNhdGlvbiBJbnRlZ3JhdGlvbiBDQSAtIEczMSYwJAYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMCCFnYobyq9OPNMAsGCWCGSAFlAwQCAaCBkzAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0yNTEyMDIwOTE3NDBaMCgGCSqGSIb3DQEJNDEbMBkwCwYJYIZIAWUDBAIBoQoGCCqGSM49BAMCMC8GCSqGSIb3DQEJBDEiBCBgEHd0qYFivIW\/juzkYS9ZM\/EJPtEof3BYxZF37VxYwTAKBggqhkjOPQQDAgRHMEUCIQDCTIdh626dVbaJN2iPnD4M0Zx8JM5FkEri+XNg8YzeOgIgBlqrEevxEHgwDRIWYVWgzC8+uYujiAiROWDEzt\/CEPcAAAAAAAA=\",\"header\":{\"ephemeralPublicKey\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEL7bmqfLGIjCAxd9WegJaS3kZcN4oqJFC+h+MjEKNXV6mWcR+wLfE39y3p\/oj33Oo1\/LI+tVcDi9\/mJHHCrR2YA==\",\"publicKeyHash\":\"hmOvu\/gjGyJ2irwuLSHzSB2irbqeEjsc\/IBnBTzfGnA=\",\"transactionId\":\"fb63b9dfd46b59420721e4a19b3e0397a9df2aa70b6337aec8a52bcf6582609f\"}},\"PaymentMethod\":{\"displayName\":\"MasterCard 2095\",\"network\":\"MasterCard\",\"type\":\"credit\"},\"TransactionIdentifier\":\"fb63b9dfd46b59420721e4a19b3e0397a9df2aa70b6337aec8a52bcf6582609f\"}"
    },
    "Order": {
        "Amount": 23
    },
    "IntegrationUrls": {
        "Redirection": "https://your-website.com/payment-callback"
    }
}

{
    "IsSuccess": true,
    "Message": "",
    "ValidationErrors": null,
    "Data": {
        "InvoiceId": "6341679",
        "PaymentId": "07076341679319334173",
        "PaymentURL": "https://your-website.com/payment-callback?paymentId=07076341679319334173&Id=07076341679319334173",
        "PaymentCompleted": true,
        "TransactionDetails": {
            "Invoice": {
                "Id": "6341679",
                "Status": "PENDING",
                "Reference": "2025001273",
                "CreationDate": "2025-12-04T06:10:11.0896736Z",
                "ExpirationDate": "2026-05-03T06:10:11.0896736Z",
                "ExternalIdentifier": null,
                "UserDefinedField": "",
                "MetaData": null
            },
            "Transaction": {
                "Id": "07076341679319334173",
                "Status": "FAILED",
                "PaymentMethod": "Apple Pay",
                "PaymentId": "07076341679319334173",
                "ReferenceId": "07076341679319334173",
                "TrackId": "04-12-2025_3193341",
                "AuthorizationId": "07076341679319334173",
                "TransactionDate": "2025-12-04T06:10:11.1521705Z",
                "ECI": "",
                "IP": {
                    "Address": "",
                    "Country": ""
                },
                "Error": {
                    "Code": "MF002",
                    "Message": "DECLINED : Do not honour"
                },
                "Card": {
                    "NameOnCard": "",
                    "Number": "520424xxxxxx1813",
                    "PanHash": "62624d11f4553f7957aa138d25481080ab4646a2e545a62c2652e09ad0d48091",
                    "ExpiryMonth": "07",
                    "ExpiryYear": "28",
                    "Brand": "Mastercard",
                    "Issuer": "",
                    "IssuerCountry": "",
                    "FundingMethod": ""
                }
            },
            "Customer": {
                "Reference": "",
                "Name": "Anonymous",
                "Mobile": "+965",
                "Email": ""
            },
            "Amount": {
                "BaseCurrency": "KWD",
                "ValueInBaseCurrency": "23",
                "ServiceCharge": "0.023",
                "ServiceChargeVAT": "0.003",
                "ReceivableAmount": "22.974",
                "DisplayCurrency": "KWD",
                "ValueInDisplayCurrency": "23",
                "PayCurrency": "KWD",
                "ValueInPayCurrency": "23"
            },
            "Suppliers": []
        }
    }
}