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” that includes an encrypted “payment data” object. You should pass this “payment data” 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 Type Description Required
user String the UID of cashier account Required
sign String signature Required
method String v3.ApplePay Required
time Long timestamp Required
  • Parameter
Parameter Type Description Required
pay_method String online Required
sub_pay_method String Apple Pay Required
operation String 1.Sales 2.Authorisation; Required
order_id String order id from Merchant Required
amount String format in cents: € 24.99 should be 24.99, the min amount is EUR 1.00 Required
currency String ISO 4217, For example EUR, CHF Required
description String order description Required
demo String custom field Optional
payment_token_object String The "payment_token_object" string obtained from Apple Pay Required
timeout String value 0 means 1440 minutes Required
notify_url String asynchronous notification url Required
request_id String The request ID must be unique. It is recommended to use a combination of at least 24 digits and letters. Required

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=2&order_id=1721985206&pay_method=online&payment_token_object=eyJwYXltZW50RGF0YSI6eyJkYXRhIjoic1RmRWRpeHcrWVBKY0RWY0prUEt1S1BSeVBBdnJXYTd1WllhOUJGMW1vVTh2YVNWUllZdmVFVzBjT2I4ZkNJL0thcGtsNkJnUE92cE1WUzNtR1dCdkhxMEZzTDB1UTVmM25YWjZuWVZ2T1BzNmRVSVlnWW95b09DRlUzSElZMGszV1dqYVV3ZE5Tb0VUeVlCZlZueDJVQ2JBRUdwcExYLzRrRzdpdzFJcFB1RGdESDdSMjZ3RjNCaThYUmNjSzc2cHc5Wm9MY3BVdnhHbTJPWmhkVnJwOFJ4dTJQOGhEaFZObEFYTGNFbjgrQWtBM2JkamdvSTVNb1NJeWNCM0htUHRBeHZnZE1HV3p1NUJtMUhoS1FMaEpPb05pSjM1alVzV1BvRzJnSURkTlRIWnhHUG03aE41akhpRURjSENYS1RFY0hENEVCeDlNazVsVndHYUdhWUFsYW9SUTlZdWVWczRWcVJVUlZGTForUVhjbWJ1aXVoT3g2WDRvSzJRRGxGU3BqYnVBMHdkZ1IrYTZFWWFXbDBZVVRTcXRDMmQ3VmNzSkJrUkJ3PSIsInNpZ25hdHVyZSI6Ik1JQUdDU3FHU0liM0RRRUhBcUNBTUlBQ0FRRXhEVEFMQmdsZ2hrZ0JaUU1FQWdFd2dBWUpLb1pJaHZjTkFRY0JBQUNnZ0RDQ0ErTXdnZ09Jb0FNQ0FRSUNDQlpqVElzT01GY1hNQW9HQ0NxR1NNNDlCQU1DTUhveExqQXNCZ05WQkFNTUpVRndjR3hsSUVGd2NHeHBZMkYwYVc5dUlFbHVkR1ZuY21GMGFXOXVJRU5CSUMwZ1J6TXhKakFrQmdOVkJBc01IVUZ3Y0d4bElFTmxjblJwWm1sallYUnBiMjRnUVhWMGFHOXlhWFI1TVJNd0VRWURWUVFLREFwQmNIQnNaU0JKYm1NdU1Rc3dDUVlEVlFRR0V3SlZVekFlRncweU5EQTBNamt4TnpRM01qZGFGdzB5T1RBME1qZ3hOelEzTWpaYU1GOHhKVEFqQmdOVkJBTU1IR1ZqWXkxemJYQXRZbkp2YTJWeUxYTnBaMjVmVlVNMExWQlNUMFF4RkRBU0JnTlZCQXNNQzJsUFV5QlRlWE4wWlcxek1STXdFUVlEVlFRS0RBcEJjSEJzWlNCSmJtTXVNUXN3Q1FZRFZRUUdFd0pWVXpCWk1CTUdCeXFHU000OUFnRUdDQ3FHU000OUF3RUhBMElBQk1JVmQrM3Ixc2V5SVk5bzNYQ1FvU0dOeDdDOWJ5d29QWVJnbGRsSzlLVkJHNE5DRHRnUjgwQitnek1mSEZURDkrc3lJTmE2MWRUdjlKS0ppVDU4RHhPamdnSVJNSUlDRFRBTUJnTlZIUk1CQWY4RUFqQUFNQjhHQTFVZEl3UVlNQmFBRkNQeVNjUlBrK1R2SitiRTlpaHNQNks3L1M1TE1FVUdDQ3NHQVFVRkJ3RUJCRGt3TnpBMUJnZ3JCZ0VGQlFjd0FZWXBhSFIwY0RvdkwyOWpjM0F1WVhCd2JHVXVZMjl0TDI5amMzQXdOQzFoY0hCc1pXRnBZMkV6TURJd2dnRWRCZ05WSFNBRWdnRVVNSUlCRURDQ0FRd0dDU3FHU0liM1kyUUZBVENCL2pDQnd3WUlLd1lCQlFVSEFnSXdnYllNZ2JOU1pXeHBZVzVqWlNCdmJpQjBhR2x6SUdObGNuUnBabWxqWVhSbElHSjVJR0Z1ZVNCd1lYSjBlU0JoYzNOMWJXVnpJR0ZqWTJWd2RHRnVZMlVnYjJZZ2RHaGxJSFJvWlc0Z1lYQndiR2xqWVdKc1pTQnpkR0Z1WkdGeVpDQjBaWEp0Y3lCaGJtUWdZMjl1WkdsMGFXOXVjeUJ2WmlCMWMyVXNJR05sY25ScFptbGpZWFJsSUhCdmJHbGplU0JoYm1RZ1kyVnlkR2xtYVdOaGRHbHZiaUJ3Y21GamRHbGpaU0J6ZEdGMFpXMWxiblJ6TGpBMkJnZ3JCZ0VGQlFjQ0FSWXFhSFIwY0RvdkwzZDNkeTVoY0hCc1pTNWpiMjB2WTJWeWRHbG1hV05oZEdWaGRYUm9iM0pwZEhrdk1EUUdBMVVkSHdRdE1Dc3dLYUFub0NXR0kyaDBkSEE2THk5amNtd3VZWEJ3YkdVdVkyOXRMMkZ3Y0d4bFlXbGpZVE11WTNKc01CMEdBMVVkRGdRV0JCU1VWOXR2MVhTQmhvbUpkaTkrVjRVSDU1dFlKREFPQmdOVkhROEJBZjhFQkFNQ0I0QXdEd1lKS29aSWh2ZGpaQVlkQkFJRkFEQUtCZ2dxaGtqT1BRUURBZ05KQURCR0FpRUF4dkFqeXlZVXV6QTRpS0ZpbUQ0YWsvRUZiMUQ2ZU0yNXVreWlRY3dVNGw0Q0lRQytQTkRmMFdKSDlrbEVkVGdPblVUQ0tLRUlrS09oM0hKTGkweTRpSmdZdkRDQ0F1NHdnZ0oxb0FNQ0FRSUNDRWx0TDc4Nm1OcVhNQW9HQ0NxR1NNNDlCQU1DTUdjeEd6QVpCZ05WQkFNTUVrRndjR3hsSUZKdmIzUWdRMEVnTFNCSE16RW1NQ1FHQTFVRUN3d2RRWEJ3YkdVZ1EyVnlkR2xtYVdOaGRHbHZiaUJCZFhSb2IzSnBkSGt4RXpBUkJnTlZCQW9NQ2tGd2NHeGxJRWx1WXk0eEN6QUpCZ05WQkFZVEFsVlRNQjRYRFRFME1EVXdOakl6TkRZek1Gb1hEVEk1TURVd05qSXpORFl6TUZvd2VqRXVNQ3dHQTFVRUF3d2xRWEJ3YkdVZ1FYQndiR2xqWVhScGIyNGdTVzUwWldkeVlYUnBiMjRnUTBFZ0xTQkhNekVtTUNRR0ExVUVDd3dkUVhCd2JHVWdRMlZ5ZEdsbWFXTmhkR2x2YmlCQmRYUm9iM0pwZEhreEV6QVJCZ05WQkFvTUNrRndjR3hsSUVsdVl5NHhDekFKQmdOVkJBWVRBbFZUTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFOEJjUmhCblhaSVhWR2w0bGdRZDI2SUNpNzk1N3JrM2dqZnhMaytFelZ0Vm1Xeld1SXRDWGRnMGlUbnU2Q1AxMkY4Nkl5M2E3Wm5DK3lPZ3BoUDlVUmFPQjl6Q0I5REJHQmdnckJnRUZCUWNCQVFRNk1EZ3dOZ1lJS3dZQkJRVUhNQUdHS21oMGRIQTZMeTl2WTNOd0xtRndjR3hsTG1OdmJTOXZZM053TURRdFlYQndiR1Z5YjI5MFkyRm5NekFkQmdOVkhRNEVGZ1FVSS9KSnhFK1Q1TzhuNXNUMktHdy9vcnY5TGtzd0R3WURWUjBUQVFIL0JBVXdBd0VCL3pBZkJnTlZIU01FR0RBV2dCUzdzTjZoV0RPSW1xU0ttZDYrdmV1djJzc2txekEzQmdOVkhSOEVNREF1TUN5Z0txQW9oaVpvZEhSd09pOHZZM0pzTG1Gd2NHeGxMbU52YlM5aGNIQnNaWEp2YjNSallXY3pMbU55YkRBT0JnTlZIUThCQWY4RUJBTUNBUVl3RUFZS0tvWklodmRqWkFZQ0RnUUNCUUF3Q2dZSUtvWkl6ajBFQXdJRFp3QXdaQUl3T3M5eWcxRVdtYkdHK3pYRFZzcGl2L1FYN2RrUGRVMmlqcjd4bklGZVFyZUorSmozbTFtZm1OVkJEWStkNmNMK0FqQXlMZFZFSWJDakJYZHNYZk00TzVCbi9SZDhMQ0Z0bGsvR2NtbUNFbTlVK0hwOUc1bkxtd21KSVdFR21ROEpraDBBQURHQ0FZZ3dnZ0dFQWdFQk1JR0dNSG94TGpBc0JnTlZCQU1NSlVGd2NHeGxJRUZ3Y0d4cFkyRjBhVzl1SUVsdWRHVm5jbUYwYVc5dUlFTkJJQzBnUnpNeEpqQWtCZ05WQkFzTUhVRndjR3hsSUVObGNuUnBabWxqWVhScGIyNGdRWFYwYUc5eWFYUjVNUk13RVFZRFZRUUtEQXBCY0hCc1pTQkpibU11TVFzd0NRWURWUVFHRXdKVlV3SUlGbU5NaXc0d1Z4Y3dDd1lKWUlaSUFXVURCQUlCb0lHVE1CZ0dDU3FHU0liM0RRRUpBekVMQmdrcWhraUc5dzBCQndFd0hBWUpLb1pJaHZjTkFRa0ZNUThYRFRJME1EY3lOakE1TVRFeU1Gb3dLQVlKS29aSWh2Y05BUWswTVJzd0dUQUxCZ2xnaGtnQlpRTUVBZ0doQ2dZSUtvWkl6ajBFQXdJd0x3WUpLb1pJaHZjTkFRa0VNU0lFSU9LL0xTaFYxdWJNMDl1ZUNqSmVmYVlqNFgxWG1XNUtGU3BBZXVMc2pPcVlNQW9HQ0NxR1NNNDlCQU1DQkVjd1JRSWdLalZWYlJtS3NvakJYNEt6M1IybUVxcUJoWGJxUVg2U044RjR2WkwxUHZnQ0lRQ0FlK1hBbHdnL1lqQkwyRUpybzdkUWg0NW5nNlNjQVI5Ym9SUi9haU85eFFBQUFBQUFBQT09IiwiaGVhZGVyIjp7InB1YmxpY0tleUhhc2giOiJnNHBucDhiY251QmtLcTZmME5ZRHVSOXB2YldHVjZZelVwd1c4SnZyZ2tRPSIsImVwaGVtZXJhbFB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTZzakwrOEVYdzZWOXc1anViTSsybHlLeUJIQ2NoWmw3ekdGQUs5T3FFTnZQc3BRRk8vbXc5RFU3d2R5aVVhWi8wTk1zZW16eDU0NWNLWWtRc0ZBbk93PT0iLCJ0cmFuc2FjdGlvbklkIjoiYWJmMzA2M2QxNGI0YzM1MzFkZTliODc0YTUxZTJmOWJmMTA0MDRmZGIwNmVkYjFlNTRkM2NhZThlZDlkMGFjZCJ9LCJ2ZXJzaW9uIjoiRUNfdjEifSwicGF5bWVudE1ldGhvZCI6eyJkaXNwbGF5TmFtZSI6IlZpc2EgNTU1OCIsIm5ldHdvcmsiOiJWaXNhIiwidHlwZSI6ImRlYml0In0sInRyYW5zYWN0aW9uSWRlbnRpZmllciI6ImFiZjMwNjNkMTRiNGMzNTMxZGU5Yjg3NGE1MWUyZjliZjEwNDA0ZmRiMDZlZGIxZTU0ZDNjYWU4ZWQ5ZDBhY2QifQ==&request_id=wp2rry7t7feg7sleipez7ox30r52bo86&sub_pay_method=Apple Pay&time=1721985206&timeout=0&user=016683"

Use stringA and secret_key to get stringSign

Get Signature:

"eca706bdf5c560238deb08500a2b722e2af69a38ed17c1cf09aaab26d8ac8d70"

Example Request (operation=1 Sales):

{
    "user": "016683",
    "sign": "eca706bdf5c560238deb08500a2b722e2af69a38ed17c1cf09aaab26d8ac8d70",
    "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. If the payment cancellation succeeds, it returns "status": true.

  2. If the payment cancellation fails, it returns "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. You can also check the order status by calling Query payment or wait for an asynchronous notification. 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:
Status Code Message
true 200
fales -1000 Internal error
fales -403 The signature Error
fales -2001 The user not exist
fales -3001 Required field is missing
fales -4118 Incorrect request ID

results matching ""

    No results matching ""