Apple Pay

Available: Apple Pay

Apple Pay is Apple’s alternative payment method allowing Apple users to pay with their devices.

1. How does it work?

Apple Pay uses device-specific tokenised credit or debit card credentials (DPAN) in place of a Payment Account Number (PAN). When a customer confirms the payment using Face ID, Touch ID or passcode, the tokenised card data is returned to your app or website. This token can then be passed on to your Payment Service Provider (PSP) to process as you would a typical online credit or debit card payment.

Any transaction type you support today for regular debit and credit cards can be performed with Apple Pay, including refunds. Apple Pay works on Apple devices running iOS, watchOS and iPadOS both in-app and in Safari, and on macOS devices in Safari.

2. Apple Pay integration

You can integrate with Apple Pay either from in-app or from the web transaction. You need to implement Apple APIs to verify that Apple Pay can be offered as a payment method:

• Integrate with the PassKit SDK to offer Apple Pay from in-app, as described in PassKit.

• Integrate with Apple Pay JS to offer Apple Pay from a web transaction, as described in Apple pay js.

After integrating with Apple Pay, you will be able to request an encrypted payload from Apple. Apple in turn will create a payment.token .Please base64_encoded string of the token data. You should pass this object to the YabandPay gateway in the payment_token_object field for decryption and processing.

3. Registration with Apple

Before starting, you need to make sure you complete the following steps on your Apple account:

1. Register for an Apple developer account. You need to enroll as an Apple Pay developer, and go through the Apple certification process as described here.

2. If you are integrating Apple Pay on the web (using Safari) make sure your server supports Apple's additional security requirements described here.

3. Get a CSR file from YabandPay.

4. Upload the signed CSR to YabandPay.

5. Add an Apple Pay button to your app or website. Use the appropriate PassKit or JavaScript APIs to render the button in your app or website so the button will always be up-to-date and localised.

More details can be found in: https://developer.apple.com/design/human-interface-guidelines/apple-pay/overview/introduction/.

API URL：https://mapi.yabandpay.com/Payments

Method：POST

POST data type：Json

• Parameter

Obtain payment_token_object:

Example of token returned by Apple Pay:

{
    "paymentData": {
        "data": "JgVJ+d85AEsahr6QiIxtAHuVpf6JUf2P3I7kUVg9lb94h1HBQfHOMfyE/mb+bi9s6cQyucUcqLDnVhIN5AgfXKn83JWGXwG8NHxcvaaHDKvmKqj5ZFkJMif2mVpDHpcTuyrOFJqkwfxYqmEnOqjTTqnlShH9RjrVnM9EWgYtj/u83ZMwg1tk7hn28wzv+nbGmvvFbBH8GfGf5JSBi/D6TPvM7iNGdskbJz5mx7nr8LyoqASoYbDgNN8TIe3TiAf65gc6TRjLVuCIj901qNVqx2jpp0RH4oVOks9CQsIrxXu0oRI4y1dp+znfwQiON8FaSQNT7RfQazeME/en6ZwcKqMDc1UC5M7sU8vb3aOj+fLp6p/LIx4x+wP8scNqOl6IGD9VWD0u+Bk3om7avCw=",
        "signature": "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",
        "header": {
            "publicKeyHash": "JOpIKu0h7dq0POFHtuK0DTbp6ILuiRghRcwfPsbn4DA=",
            "ephemeralPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEiarI1HHCBwLD0mfZMFf5HkTKPR4SKtM6xz1xiO57+JjwB0bR3qjhBOU7pkQQACGZgndR1nlVbVqp/N5ZrvKF9g==",
            "transactionId": "9bd4b1969b482866b5786e0971efa1d42f25ab4f9b3124b894ea2be312753b7f"
        },
        "version": "EC_v1"
    },
    "paymentMethod": {
        "displayName": "Maestro 4199",
        "network": "Maestro",
        "type": "debit"
    },
    "transactionIdentifier": "9bd4b1969b482866b5786e0971efa1d42f25ab4f9b3124b894ea2be312753b7f"
}

The payment_token_object field is the base64_encoded string of the token data obtained after connecting to Apple Pay.

Signature:

Lexicographical sequence and URL key-value format new string

"amount=0.1&currency=EUR&description=test&method=v3.ApplePay&notify_url=https://www.yabandpay.com/notify&operation=1&order_id=1721987969&pay_method=online&payment_token_object=eyJwYXltZW50RGF0YSI6eyJkYXRhIjoic1RmRWRpeHcrWVBKY0RWY0prUEt1S1BSeVBBdnJXYTd1WllhOUJGMW1vVTh2YVNWUllZdmVFVzBjT2I4ZkNJL0thcGtsNkJnUE92cE1WUzNtR1dCdkhxMEZzTDB1UTVmM25YWjZuWVZ2T1BzNmRVSVlnWW95b09DRlUzSElZMGszV1dqYVV3ZE5Tb0VUeVlCZlZueDJVQ2JBRUdwcExYLzRrRzdpdzFJcFB1RGdESDdSMjZ3RjNCaThYUmNjSzc2cHc5Wm9MY3BVdnhHbTJPWmhkVnJwOFJ4dTJQOGhEaFZObEFYTGNFbjgrQWtBM2JkamdvSTVNb1NJeWNCM0htUHRBeHZnZE1HV3p1NUJtMUhoS1FMaEpPb05pSjM1alVzV1BvRzJnSURkTlRIWnhHUG03aE41akhpRURjSENYS1RFY0hENEVCeDlNazVsVndHYUdhWUFsYW9SUTlZdWVWczRWcVJVUlZGTForUVhjbWJ1aXVoT3g2WDRvSzJRRGxGU3BqYnVBMHdkZ1IrYTZFWWFXbDBZVVRTcXRDMmQ3VmNzSkJrUkJ3PSIsInNpZ25hdHVyZSI6Ik1JQUdDU3FHU0liM0RRRUhBcUNBTUlBQ0FRRXhEVEFMQmdsZ2hrZ0JaUU1FQWdFd2dBWUpLb1pJaHZjTkFRY0JBQUNnZ0RDQ0ErTXdnZ09Jb0FNQ0FRSUNDQlpqVElzT01GY1hNQW9HQ0NxR1NNNDlCQU1DTUhveExqQXNCZ05WQkFNTUpVRndjR3hsSUVGd2NHeHBZMkYwYVc5dUlFbHVkR1ZuY21GMGFXOXVJRU5CSUMwZ1J6TXhKakFrQmdOVkJBc01IVUZ3Y0d4bElFTmxjblJwWm1sallYUnBiMjRnUVhWMGFHOXlhWFI1TVJNd0VRWURWUVFLREFwQmNIQnNaU0JKYm1NdU1Rc3dDUVlEVlFRR0V3SlZVekFlRncweU5EQTBNamt4TnpRM01qZGFGdzB5T1RBME1qZ3hOelEzTWpaYU1GOHhKVEFqQmdOVkJBTU1IR1ZqWXkxemJYQXRZbkp2YTJWeUxYTnBaMjVmVlVNMExWQlNUMFF4RkRBU0JnTlZCQXNNQzJsUFV5QlRlWE4wWlcxek1STXdFUVlEVlFRS0RBcEJjSEJzWlNCSmJtTXVNUXN3Q1FZRFZRUUdFd0pWVXpCWk1CTUdCeXFHU000OUFnRUdDQ3FHU000OUF3RUhBMElBQk1JVmQrM3Ixc2V5SVk5bzNYQ1FvU0dOeDdDOWJ5d29QWVJnbGRsSzlLVkJHNE5DRHRnUjgwQitnek1mSEZURDkrc3lJTmE2MWRUdjlKS0ppVDU4RHhPamdnSVJNSUlDRFRBTUJnTlZIUk1CQWY4RUFqQUFNQjhHQTFVZEl3UVlNQmFBRkNQeVNjUlBrK1R2SitiRTlpaHNQNks3L1M1TE1FVUdDQ3NHQVFVRkJ3RUJCRGt3TnpBMUJnZ3JCZ0VGQlFjd0FZWXBhSFIwY0RvdkwyOWpjM0F1WVhCd2JHVXVZMjl0TDI5amMzQXdOQzFoY0hCc1pXRnBZMkV6TURJd2dnRWRCZ05WSFNBRWdnRVVNSUlCRURDQ0FRd0dDU3FHU0liM1kyUUZBVENCL2pDQnd3WUlLd1lCQlFVSEFnSXdnYllNZ2JOU1pXeHBZVzVqWlNCdmJpQjBhR2x6SUdObGNuUnBabWxqWVhSbElHSjVJR0Z1ZVNCd1lYSjBlU0JoYzNOMWJXVnpJR0ZqWTJWd2RHRnVZMlVnYjJZZ2RHaGxJSFJvWlc0Z1lYQndiR2xqWVdKc1pTQnpkR0Z1WkdGeVpDQjBaWEp0Y3lCaGJtUWdZMjl1WkdsMGFXOXVjeUJ2WmlCMWMyVXNJR05sY25ScFptbGpZWFJsSUhCdmJHbGplU0JoYm1RZ1kyVnlkR2xtYVdOaGRHbHZiaUJ3Y21GamRHbGpaU0J6ZEdGMFpXMWxiblJ6TGpBMkJnZ3JCZ0VGQlFjQ0FSWXFhSFIwY0RvdkwzZDNkeTVoY0hCc1pTNWpiMjB2WTJWeWRHbG1hV05oZEdWaGRYUm9iM0pwZEhrdk1EUUdBMVVkSHdRdE1Dc3dLYUFub0NXR0kyaDBkSEE2THk5amNtd3VZWEJ3YkdVdVkyOXRMMkZ3Y0d4bFlXbGpZVE11WTNKc01CMEdBMVVkRGdRV0JCU1VWOXR2MVhTQmhvbUpkaTkrVjRVSDU1dFlKREFPQmdOVkhROEJBZjhFQkFNQ0I0QXdEd1lKS29aSWh2ZGpaQVlkQkFJRkFEQUtCZ2dxaGtqT1BRUURBZ05KQURCR0FpRUF4dkFqeXlZVXV6QTRpS0ZpbUQ0YWsvRUZiMUQ2ZU0yNXVreWlRY3dVNGw0Q0lRQytQTkRmMFdKSDlrbEVkVGdPblVUQ0tLRUlrS09oM0hKTGkweTRpSmdZdkRDQ0F1NHdnZ0oxb0FNQ0FRSUNDRWx0TDc4Nm1OcVhNQW9HQ0NxR1NNNDlCQU1DTUdjeEd6QVpCZ05WQkFNTUVrRndjR3hsSUZKdmIzUWdRMEVnTFNCSE16RW1NQ1FHQTFVRUN3d2RRWEJ3YkdVZ1EyVnlkR2xtYVdOaGRHbHZiaUJCZFhSb2IzSnBkSGt4RXpBUkJnTlZCQW9NQ2tGd2NHeGxJRWx1WXk0eEN6QUpCZ05WQkFZVEFsVlRNQjRYRFRFME1EVXdOakl6TkRZek1Gb1hEVEk1TURVd05qSXpORFl6TUZvd2VqRXVNQ3dHQTFVRUF3d2xRWEJ3YkdVZ1FYQndiR2xqWVhScGIyNGdTVzUwWldkeVlYUnBiMjRnUTBFZ0xTQkhNekVtTUNRR0ExVUVDd3dkUVhCd2JHVWdRMlZ5ZEdsbWFXTmhkR2x2YmlCQmRYUm9iM0pwZEhreEV6QVJCZ05WQkFvTUNrRndjR3hsSUVsdVl5NHhDekFKQmdOVkJBWVRBbFZUTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFOEJjUmhCblhaSVhWR2w0bGdRZDI2SUNpNzk1N3JrM2dqZnhMaytFelZ0Vm1Xeld1SXRDWGRnMGlUbnU2Q1AxMkY4Nkl5M2E3Wm5DK3lPZ3BoUDlVUmFPQjl6Q0I5REJHQmdnckJnRUZCUWNCQVFRNk1EZ3dOZ1lJS3dZQkJRVUhNQUdHS21oMGRIQTZMeTl2WTNOd0xtRndjR3hsTG1OdmJTOXZZM053TURRdFlYQndiR1Z5YjI5MFkyRm5NekFkQmdOVkhRNEVGZ1FVSS9KSnhFK1Q1TzhuNXNUMktHdy9vcnY5TGtzd0R3WURWUjBUQVFIL0JBVXdBd0VCL3pBZkJnTlZIU01FR0RBV2dCUzdzTjZoV0RPSW1xU0ttZDYrdmV1djJzc2txekEzQmdOVkhSOEVNREF1TUN5Z0txQW9oaVpvZEhSd09pOHZZM0pzTG1Gd2NHeGxMbU52YlM5aGNIQnNaWEp2YjNSallXY3pMbU55YkRBT0JnTlZIUThCQWY4RUJBTUNBUVl3RUFZS0tvWklodmRqWkFZQ0RnUUNCUUF3Q2dZSUtvWkl6ajBFQXdJRFp3QXdaQUl3T3M5eWcxRVdtYkdHK3pYRFZzcGl2L1FYN2RrUGRVMmlqcjd4bklGZVFyZUorSmozbTFtZm1OVkJEWStkNmNMK0FqQXlMZFZFSWJDakJYZHNYZk00TzVCbi9SZDhMQ0Z0bGsvR2NtbUNFbTlVK0hwOUc1bkxtd21KSVdFR21ROEpraDBBQURHQ0FZZ3dnZ0dFQWdFQk1JR0dNSG94TGpBc0JnTlZCQU1NSlVGd2NHeGxJRUZ3Y0d4cFkyRjBhVzl1SUVsdWRHVm5jbUYwYVc5dUlFTkJJQzBnUnpNeEpqQWtCZ05WQkFzTUhVRndjR3hsSUVObGNuUnBabWxqWVhScGIyNGdRWFYwYUc5eWFYUjVNUk13RVFZRFZRUUtEQXBCY0hCc1pTQkpibU11TVFzd0NRWURWUVFHRXdKVlV3SUlGbU5NaXc0d1Z4Y3dDd1lKWUlaSUFXVURCQUlCb0lHVE1CZ0dDU3FHU0liM0RRRUpBekVMQmdrcWhraUc5dzBCQndFd0hBWUpLb1pJaHZjTkFRa0ZNUThYRFRJME1EY3lOakE1TVRFeU1Gb3dLQVlKS29aSWh2Y05BUWswTVJzd0dUQUxCZ2xnaGtnQlpRTUVBZ0doQ2dZSUtvWkl6ajBFQXdJd0x3WUpLb1pJaHZjTkFRa0VNU0lFSU9LL0xTaFYxdWJNMDl1ZUNqSmVmYVlqNFgxWG1XNUtGU3BBZXVMc2pPcVlNQW9HQ0NxR1NNNDlCQU1DQkVjd1JRSWdLalZWYlJtS3NvakJYNEt6M1IybUVxcUJoWGJxUVg2U044RjR2WkwxUHZnQ0lRQ0FlK1hBbHdnL1lqQkwyRUpybzdkUWg0NW5nNlNjQVI5Ym9SUi9haU85eFFBQUFBQUFBQT09IiwiaGVhZGVyIjp7InB1YmxpY0tleUhhc2giOiJnNHBucDhiY251QmtLcTZmME5ZRHVSOXB2YldHVjZZelVwd1c4SnZyZ2tRPSIsImVwaGVtZXJhbFB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTZzakwrOEVYdzZWOXc1anViTSsybHlLeUJIQ2NoWmw3ekdGQUs5T3FFTnZQc3BRRk8vbXc5RFU3d2R5aVVhWi8wTk1zZW16eDU0NWNLWWtRc0ZBbk93PT0iLCJ0cmFuc2FjdGlvbklkIjoiYWJmMzA2M2QxNGI0YzM1MzFkZTliODc0YTUxZTJmOWJmMTA0MDRmZGIwNmVkYjFlNTRkM2NhZThlZDlkMGFjZCJ9LCJ2ZXJzaW9uIjoiRUNfdjEifSwicGF5bWVudE1ldGhvZCI6eyJkaXNwbGF5TmFtZSI6IlZpc2EgNTU1OCIsIm5ldHdvcmsiOiJWaXNhIiwidHlwZSI6ImRlYml0In0sInRyYW5zYWN0aW9uSWRlbnRpZmllciI6ImFiZjMwNjNkMTRiNGMzNTMxZGU5Yjg3NGE1MWUyZjliZjEwNDA0ZmRiMDZlZGIxZTU0ZDNjYWU4ZWQ5ZDBhY2QifQ&request_id=5g71qqe2v3twvm1sr71e74al5h7q4pbq&sub_pay_method=Apple Pay&time=1721987969&timeout=0&user=016683"

Use stringA and secret_key to get stringSign

Get Signature：

"12867d824b141542b6d78f705e3c206ebd7354bd9e50429ad22e84fbcfda621b"

Example Request (operation=1 Sales):

{
    "user": "016683",
    "sign": "12867d824b141542b6d78f705e3c206ebd7354bd9e50429ad22e84fbcfda621b",
    "method": "v3.ApplePay",
    "time": 1721987969,
    "data": {
        "description": "test",
        "timeout": "0",
        "pay_method": "online",
        "sub_pay_method": "Apple Pay",
        "order_id": 1721987969,
        "amount": "0.1",
        "currency": "EUR",
        "operation": "1",
        "notify_url": "https://www.yabandpay.com/notify",
        "payment_token_object": "eyJwYXltZW50RGF0YSI6eyJkYXRhIjoic1RmRWRpeHcrWVBKY0RWY0prUEt1S1BSeVBBdnJXYTd1WllhOUJGMW1vVTh2YVNWUllZdmVFVzBjT2I4ZkNJL0thcGtsNkJnUE92cE1WUzNtR1dCdkhxMEZzTDB1UTVmM25YWjZuWVZ2T1BzNmRVSVlnWW95b09DRlUzSElZMGszV1dqYVV3ZE5Tb0VUeVlCZlZueDJVQ2JBRUdwcExYLzRrRzdpdzFJcFB1RGdESDdSMjZ3RjNCaThYUmNjSzc2cHc5Wm9MY3BVdnhHbTJPWmhkVnJwOFJ4dTJQOGhEaFZObEFYTGNFbjgrQWtBM2JkamdvSTVNb1NJeWNCM0htUHRBeHZnZE1HV3p1NUJtMUhoS1FMaEpPb05pSjM1alVzV1BvRzJnSURkTlRIWnhHUG03aE41akhpRURjSENYS1RFY0hENEVCeDlNazVsVndHYUdhWUFsYW9SUTlZdWVWczRWcVJVUlZGTForUVhjbWJ1aXVoT3g2WDRvSzJRRGxGU3BqYnVBMHdkZ1IrYTZFWWFXbDBZVVRTcXRDMmQ3VmNzSkJrUkJ3PSIsInNpZ25hdHVyZSI6Ik1JQUdDU3FHU0liM0RRRUhBcUNBTUlBQ0FRRXhEVEFMQmdsZ2hrZ0JaUU1FQWdFd2dBWUpLb1pJaHZjTkFRY0JBQUNnZ0RDQ0ErTXdnZ09Jb0FNQ0FRSUNDQlpqVElzT01GY1hNQW9HQ0NxR1NNNDlCQU1DTUhveExqQXNCZ05WQkFNTUpVRndjR3hsSUVGd2NHeHBZMkYwYVc5dUlFbHVkR1ZuY21GMGFXOXVJRU5CSUMwZ1J6TXhKakFrQmdOVkJBc01IVUZ3Y0d4bElFTmxjblJwWm1sallYUnBiMjRnUVhWMGFHOXlhWFI1TVJNd0VRWURWUVFLREFwQmNIQnNaU0JKYm1NdU1Rc3dDUVlEVlFRR0V3SlZVekFlRncweU5EQTBNamt4TnpRM01qZGFGdzB5T1RBME1qZ3hOelEzTWpaYU1GOHhKVEFqQmdOVkJBTU1IR1ZqWXkxemJYQXRZbkp2YTJWeUxYTnBaMjVmVlVNMExWQlNUMFF4RkRBU0JnTlZCQXNNQzJsUFV5QlRlWE4wWlcxek1STXdFUVlEVlFRS0RBcEJjSEJzWlNCSmJtTXVNUXN3Q1FZRFZRUUdFd0pWVXpCWk1CTUdCeXFHU000OUFnRUdDQ3FHU000OUF3RUhBMElBQk1JVmQrM3Ixc2V5SVk5bzNYQ1FvU0dOeDdDOWJ5d29QWVJnbGRsSzlLVkJHNE5DRHRnUjgwQitnek1mSEZURDkrc3lJTmE2MWRUdjlKS0ppVDU4RHhPamdnSVJNSUlDRFRBTUJnTlZIUk1CQWY4RUFqQUFNQjhHQTFVZEl3UVlNQmFBRkNQeVNjUlBrK1R2SitiRTlpaHNQNks3L1M1TE1FVUdDQ3NHQVFVRkJ3RUJCRGt3TnpBMUJnZ3JCZ0VGQlFjd0FZWXBhSFIwY0RvdkwyOWpjM0F1WVhCd2JHVXVZMjl0TDI5amMzQXdOQzFoY0hCc1pXRnBZMkV6TURJd2dnRWRCZ05WSFNBRWdnRVVNSUlCRURDQ0FRd0dDU3FHU0liM1kyUUZBVENCL2pDQnd3WUlLd1lCQlFVSEFnSXdnYllNZ2JOU1pXeHBZVzVqWlNCdmJpQjBhR2x6SUdObGNuUnBabWxqWVhSbElHSjVJR0Z1ZVNCd1lYSjBlU0JoYzNOMWJXVnpJR0ZqWTJWd2RHRnVZMlVnYjJZZ2RHaGxJSFJvWlc0Z1lYQndiR2xqWVdKc1pTQnpkR0Z1WkdGeVpDQjBaWEp0Y3lCaGJtUWdZMjl1WkdsMGFXOXVjeUJ2WmlCMWMyVXNJR05sY25ScFptbGpZWFJsSUhCdmJHbGplU0JoYm1RZ1kyVnlkR2xtYVdOaGRHbHZiaUJ3Y21GamRHbGpaU0J6ZEdGMFpXMWxiblJ6TGpBMkJnZ3JCZ0VGQlFjQ0FSWXFhSFIwY0RvdkwzZDNkeTVoY0hCc1pTNWpiMjB2WTJWeWRHbG1hV05oZEdWaGRYUm9iM0pwZEhrdk1EUUdBMVVkSHdRdE1Dc3dLYUFub0NXR0kyaDBkSEE2THk5amNtd3VZWEJ3YkdVdVkyOXRMMkZ3Y0d4bFlXbGpZVE11WTNKc01CMEdBMVVkRGdRV0JCU1VWOXR2MVhTQmhvbUpkaTkrVjRVSDU1dFlKREFPQmdOVkhROEJBZjhFQkFNQ0I0QXdEd1lKS29aSWh2ZGpaQVlkQkFJRkFEQUtCZ2dxaGtqT1BRUURBZ05KQURCR0FpRUF4dkFqeXlZVXV6QTRpS0ZpbUQ0YWsvRUZiMUQ2ZU0yNXVreWlRY3dVNGw0Q0lRQytQTkRmMFdKSDlrbEVkVGdPblVUQ0tLRUlrS09oM0hKTGkweTRpSmdZdkRDQ0F1NHdnZ0oxb0FNQ0FRSUNDRWx0TDc4Nm1OcVhNQW9HQ0NxR1NNNDlCQU1DTUdjeEd6QVpCZ05WQkFNTUVrRndjR3hsSUZKdmIzUWdRMEVnTFNCSE16RW1NQ1FHQTFVRUN3d2RRWEJ3YkdVZ1EyVnlkR2xtYVdOaGRHbHZiaUJCZFhSb2IzSnBkSGt4RXpBUkJnTlZCQW9NQ2tGd2NHeGxJRWx1WXk0eEN6QUpCZ05WQkFZVEFsVlRNQjRYRFRFME1EVXdOakl6TkRZek1Gb1hEVEk1TURVd05qSXpORFl6TUZvd2VqRXVNQ3dHQTFVRUF3d2xRWEJ3YkdVZ1FYQndiR2xqWVhScGIyNGdTVzUwWldkeVlYUnBiMjRnUTBFZ0xTQkhNekVtTUNRR0ExVUVDd3dkUVhCd2JHVWdRMlZ5ZEdsbWFXTmhkR2x2YmlCQmRYUm9iM0pwZEhreEV6QVJCZ05WQkFvTUNrRndjR3hsSUVsdVl5NHhDekFKQmdOVkJBWVRBbFZUTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFOEJjUmhCblhaSVhWR2w0bGdRZDI2SUNpNzk1N3JrM2dqZnhMaytFelZ0Vm1Xeld1SXRDWGRnMGlUbnU2Q1AxMkY4Nkl5M2E3Wm5DK3lPZ3BoUDlVUmFPQjl6Q0I5REJHQmdnckJnRUZCUWNCQVFRNk1EZ3dOZ1lJS3dZQkJRVUhNQUdHS21oMGRIQTZMeTl2WTNOd0xtRndjR3hsTG1OdmJTOXZZM053TURRdFlYQndiR1Z5YjI5MFkyRm5NekFkQmdOVkhRNEVGZ1FVSS9KSnhFK1Q1TzhuNXNUMktHdy9vcnY5TGtzd0R3WURWUjBUQVFIL0JBVXdBd0VCL3pBZkJnTlZIU01FR0RBV2dCUzdzTjZoV0RPSW1xU0ttZDYrdmV1djJzc2txekEzQmdOVkhSOEVNREF1TUN5Z0txQW9oaVpvZEhSd09pOHZZM0pzTG1Gd2NHeGxMbU52YlM5aGNIQnNaWEp2YjNSallXY3pMbU55YkRBT0JnTlZIUThCQWY4RUJBTUNBUVl3RUFZS0tvWklodmRqWkFZQ0RnUUNCUUF3Q2dZSUtvWkl6ajBFQXdJRFp3QXdaQUl3T3M5eWcxRVdtYkdHK3pYRFZzcGl2L1FYN2RrUGRVMmlqcjd4bklGZVFyZUorSmozbTFtZm1OVkJEWStkNmNMK0FqQXlMZFZFSWJDakJYZHNYZk00TzVCbi9SZDhMQ0Z0bGsvR2NtbUNFbTlVK0hwOUc1bkxtd21KSVdFR21ROEpraDBBQURHQ0FZZ3dnZ0dFQWdFQk1JR0dNSG94TGpBc0JnTlZCQU1NSlVGd2NHeGxJRUZ3Y0d4cFkyRjBhVzl1SUVsdWRHVm5jbUYwYVc5dUlFTkJJQzBnUnpNeEpqQWtCZ05WQkFzTUhVRndjR3hsSUVObGNuUnBabWxqWVhScGIyNGdRWFYwYUc5eWFYUjVNUk13RVFZRFZRUUtEQXBCY0hCc1pTQkpibU11TVFzd0NRWURWUVFHRXdKVlV3SUlGbU5NaXc0d1Z4Y3dDd1lKWUlaSUFXVURCQUlCb0lHVE1CZ0dDU3FHU0liM0RRRUpBekVMQmdrcWhraUc5dzBCQndFd0hBWUpLb1pJaHZjTkFRa0ZNUThYRFRJME1EY3lOakE1TVRFeU1Gb3dLQVlKS29aSWh2Y05BUWswTVJzd0dUQUxCZ2xnaGtnQlpRTUVBZ0doQ2dZSUtvWkl6ajBFQXdJd0x3WUpLb1pJaHZjTkFRa0VNU0lFSU9LL0xTaFYxdWJNMDl1ZUNqSmVmYVlqNFgxWG1XNUtGU3BBZXVMc2pPcVlNQW9HQ0NxR1NNNDlCQU1DQkVjd1JRSWdLalZWYlJtS3NvakJYNEt6M1IybUVxcUJoWGJxUVg2U044RjR2WkwxUHZnQ0lRQ0FlK1hBbHdnL1lqQkwyRUpybzdkUWg0NW5nNlNjQVI5Ym9SUi9haU85eFFBQUFBQUFBQT09IiwiaGVhZGVyIjp7InB1YmxpY0tleUhhc2giOiJnNHBucDhiY251QmtLcTZmME5ZRHVSOXB2YldHVjZZelVwd1c4SnZyZ2tRPSIsImVwaGVtZXJhbFB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTZzakwrOEVYdzZWOXc1anViTSsybHlLeUJIQ2NoWmw3ekdGQUs5T3FFTnZQc3BRRk8vbXc5RFU3d2R5aVVhWi8wTk1zZW16eDU0NWNLWWtRc0ZBbk93PT0iLCJ0cmFuc2FjdGlvbklkIjoiYWJmMzA2M2QxNGI0YzM1MzFkZTliODc0YTUxZTJmOWJmMTA0MDRmZGIwNmVkYjFlNTRkM2NhZThlZDlkMGFjZCJ9LCJ2ZXJzaW9uIjoiRUNfdjEifSwicGF5bWVudE1ldGhvZCI6eyJkaXNwbGF5TmFtZSI6IlZpc2EgNTU1OCIsIm5ldHdvcmsiOiJWaXNhIiwidHlwZSI6ImRlYml0In0sInRyYW5zYWN0aW9uSWRlbnRpZmllciI6ImFiZjMwNjNkMTRiNGMzNTMxZGU5Yjg3NGE1MWUyZjliZjEwNDA0ZmRiMDZlZGIxZTU0ZDNjYWU4ZWQ5ZDBhY2QifQ",
        "request_id": "5g71qqe2v3twvm1sr71e74al5h7q4pbq"
    }
}

Example Response:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "1721987969",
        "trade_id": "8c9908cf-0df7-7e22-1724-0080246bb918",
        "amount": "0.10",
        "currency": "EUR",
        "settlement_amount": "0.10",
        "settlement_currency": "EUR",
        "exchange_rate": "1",
        "sub_pay_method": "Apple Pay",
        "state": "paid",
    },
    "message": "",
    "response_id": "202407261759298674663100"
}

More Information:

Return results:

1. On a successful API call, the response will be "status": true.

2. On a failed API call, the response will be "status": false.

You need to redirect to the returned url. After the user enters their card information and completes the payment at this url, they will be redirected back to the redirect_url.

We strongly recommend using both Order Query and Asynchronous Notification simultaneously to synchronize and update payment status, ensuring real-time accuracy of payment information.

If the order status state is paid, the payment is successful. If the order status state is authorized, the authorisation is successful.

Result/Error codes: