Apple Pay - Requests

Pay

The Pay action is the default action. The action is used to perform a single payment with Apple Pay.

📘

Note

Use the base request as instructed on this page.

Parameters

Service-specific parameters

ParameterTypeRequiredRecommendedDescription
PaymentDataStringYesN/AThis can be retrieved from the "captureInfo"-variables of our Client Side Encryption SDK.
CustomerCardNameStringNoN/AThis can be retrieved from the "captureInfo"-variables of our Client Side Encryption SDK.
📘

PaymentData

PaymentData is the encrypted Apple Pay payment token, base64-encoded, as produced by the BuckarooSdk on the device. It is consumed once, on the Authorize (or Pay) request, where Buckaroo decrypts it to obtain the card details and cryptogram. Follow-up actions in the same flow -- Capture, CancelAuthorize and Refund -- are identified by OriginalTransactionKey and do NOT need PaymentData; the card data is reloaded from the original Authorize. If PaymentData is sent on a Capture it is accepted and ignored.

Basic Parameters:

  • Find basic parameters here.

Example request 1 (requires domain association file)

{
   "Currency": "EUR",
   "AmountDebit": 1.00,
   "Invoice": "10000480",
   "Services": {
      "ServiceList": [
         {
            "Name": "applepay",
            "Action": "Pay",
            "Parameters": [
               {
                  "Name": "PaymentData",
                  "Value": "XXXXXXXXXXXXX"
               },
               {
                  "Name": "CustomerCardName",
                  "Value": "XXXXXXXXXXXXX"
               }
            ]
         }
      ]
   }
}

Pay Response

Parameters

Service-specific parameters

ParameterTypeRequiredRecommendedDescription
CardNumberEndingStringLast 4 digits of the credit card number.
CardExpirationDateStringCredit card expiration date.
MaskedCreditcardNumberStringMasked card number.

Example response

{
   "Key": "9AA4C81A08A84FA7B68E6A6A6291XXXX",
   "Status": {
      "Code": {
         "Code": 190,
         "Description": "Success"
      },
      "SubCode": {
         "Code": "S001",
         "Description": "Transaction successfully processed"
      },
      "DateTime": "2019-06-13T09:19:52"
   },
   "RequiredAction": null,
   "Services": [
      {
         "Name": "applepay",
         "Action": null,
         "Parameters": [
            {
               "Name": "CardNumberEnding",
               "Value": "00XX"
            },
            {
               "Name": "CardExpirationDate",
               "Value": "0019-07"
            },
            {
               "Name": "MaskedCreditcardNumber",
               "Value": "XXXXXX******XXXX"
            }
         ]
      }
   ],
   "CustomParameters": null,
   "RequestErrors": null,
   "Invoice": "10000480",
   "ServiceCode": "applepay",
   "IsTest": true,
   "Currency": "EUR",
   "AmountDebit": 1.00,
   "TransactionType": "V187",
   "MutationType": 2,
   "RelatedTransactions": null,
   "ConsumerMessage": null,
   "Order": "10000480",
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": "XXXXXXXXXXXX",
   "PayerHash": "XXXXXXXXXXXXXXXXXXX",
   "PaymentKey": "XXXXXXXXXXXXXXXXXXXXXX"
}

Example request 2 (does not require a domain association file)

{
 "Currency": "EUR",
 "AmountDebit": 10.00,
 "Description": "Apple Pay without domain assocation file",
 "Invoice": "12345678",
 "ReturnURL": "https://www.buckaroo.nl",
 "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
 "ReturnURLError": "https://www.buckaroo.nl/mislukt",
 "ServicesSelectableByClient": "applepay",
 "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
 "ContinueOnIncomplete": "1"
}


Pay Push

Parameters

Service-specific parameters

ParameterTypeRequiredRecommendedDescription
CardNumberEndingStringLast 4 digits of the credit card number.
CardExpirationDateStringCredit card expiration date.
MaskedCreditcardNumberStringMasked card number.

Example Push

{
   "Transaction": {
      "Key": "9AA4C81A08A84FA7B68E6A6A6291XXXX",
      "Invoice": "10000480",
      "ServiceCode": "applepay",
      "Status": {
         "Code": {
            "Code": 190,
            "Description": "Success"
         },
         "SubCode": {
            "Code": "S001",
            "Description": "Transaction successfully processed"
         },
         "DateTime": "2019-06-13T09:19:52"
      },
      "IsTest": true,
      "Order": "10000480",
      "Currency": "EUR",
      "AmountDebit": 1,
      "TransactionType": "V187",
      "Services": [
         {
            "Name": "applepay",
            "Action": null,
            "Parameters": [
               {
                  "Name": "CardNumberEnding",
                  "Value": "00XX"
               },
               {
                  "Name": "CardExpirationDate",
                  "Value": "0019-07"
               },
               {
                  "Name": "MaskedCreditcardNumber",
                  "Value": "XXXXXX******XXXX"
               }
            ],
            "VersionAsProperty": 1
         }
      ],
      "CustomParameters": null,
      "MutationType": 2,
      "RelatedTransactions": null,
      "IsCancelable": false,
      "IssuingCountry": null,
      "StartRecurrent": false,
      "Recurring": false,
      "CustomerName": "XXXXXXXXXXXX",
      "PayerHash": "XXXXXXXXXXXXXXXXXXX",
      "PaymentKey": "XXXXXXXXXXXXXXXXXXXXXX"
   }
}

Authorize

The Authorize action reserves funds on the card behind the buyer's Apple Pay wallet without moving them. During the authorization window the merchant can capture the funds (a full capture or a single partial capture) or release them by sending a CancelAuthorize.

Apple Pay has a single flow (there is no redirect): the buyer approves the payment in the Apple Pay sheet, which the BuckarooSdk renders client-side. The SDK hands the merchant the encrypted Apple Pay token; the merchant's server then posts an Authorize gateway request carrying that token as PaymentData. There is no 3-D Secure step.

Parameters

Service-specific parameters

ParameterTypeRequiredRecommendedDescription
PaymentDataStringYesN/ABase64-encoded, encrypted Apple Pay payment token (PKPaymentToken). Produced by the BuckarooSdk. See the Client SDK.
CustomerCardNameStringNoN/ADisplay name for the card. If omitted, it is taken from the token, otherwise it defaults to "Customer Unknown".

Basic Parameters:

  • Find basic parameters here.

Example request

{
   "Currency": "EUR",
   "AmountDebit": 10.00,
   "Invoice": "testinvoice 123",
   "Services": {
      "ServiceList": [
         {
            "Name": "applepay",
            "Action": "Authorize",
            "Parameters": [
               {
                  "Name": "PaymentData",
                  "Value": "eyJkYXRhIjoiU2FtcGxl...base64-encoded-Apple-Pay-token...XXXX"
               }
            ]
         }
      ]
   }
}

Authorize Response

Parameters

Service-specific parameters

ParameterTypeRequiredRecommendedDescription
CardNumberEndingStringLast four digits of the card behind the Apple Pay token.
CardExpirationDateStringCard expiry in "yyyy-MM" format.
MaskedCreditcardNumberStringMasked card number (only the last digits are shown).
📘

Note

These come from the standard card output set. Apple Pay does not return payer name/address parameters the way PayPal does, because the wallet only exposes the tokenized card.

⚠️

The Status SubCode and the exact output field names below are illustrative; confirm them against a live test response.

Example response

{
   "Key": "8E04704995B74D679AACC59F87XXXXXX",
   "Status": {
      "Code": {
         "Code": 190,
         "Description": "Success"
      },
      "SubCode": {
         "Code": "S001",
         "Description": "Transaction successfully processed"
      },
      "DateTime": "2026-05-22T15:58:56"
   },
   "RequiredAction": null,
   "Services": [
      {
         "Name": "applepay",
         "Action": null,
         "Parameters": [
            {
               "Name": "CardNumberEnding",
               "Value": "1234"
            },
            {
               "Name": "CardExpirationDate",
               "Value": "2028-09"
            },
            {
               "Name": "MaskedCreditcardNumber",
               "Value": "**** **** **** 1234"
            }
         ]
      }
   ],
   "CustomParameters": null,
   "AdditionalParameters": null,
   "RequestErrors": null,
   "Invoice": "testinvoice 123",
   "ServiceCode": "applepay",
   "IsTest": true,
   "Currency": "EUR",
   "AmountDebit": 10.0,
   "TransactionType": "I151",
   "MutationType": 1,
   "RelatedTransactions": null,
   "ConsumerMessage": null,
   "Order": null,
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": "John Smith",
   "PayerHash": null,
   "PaymentKey": null
}

Authorize Push

Parameters

Service-specific parameters

ParameterTypeRequiredRecommendedDescription
CardNumberEndingStringLast four digits of the card behind the Apple Pay token.
CardExpirationDateStringCard expiry in "yyyy-MM" format.
MaskedCreditcardNumberStringMasked card number (only the last digits are shown).

Example Push

{
   "Transaction": {
      "Key": "8E04704995B74D679AACC59F87XXXXXX",
      "Invoice": "testinvoice 123",
      "ServiceCode": "applepay",
      "Status": {
         "Code": {
            "Code": 190,
            "Description": "Success"
         },
         "SubCode": {
            "Code": "S001",
            "Description": "Transaction successfully processed"
         },
         "DateTime": "2026-05-22T16:00:04"
      },
      "IsTest": true,
      "Order": null,
      "Currency": "EUR",
      "AmountDebit": 10.0,
      "TransactionType": "I151",
      "Services": [
         {
            "Name": "applepay",
            "Action": null,
            "Parameters": [
               {
                  "Name": "CardNumberEnding",
                  "Value": "1234"
               },
               {
                  "Name": "CardExpirationDate",
                  "Value": "2028-09"
               },
               {
                  "Name": "MaskedCreditcardNumber",
                  "Value": "**** **** **** 1234"
               }
            ],
            "VersionAsProperty": 1
         }
      ],
      "CustomParameters": null,
      "AdditionalParameters": null,
      "MutationType": 1,
      "RelatedTransactions": null,
      "IsCancelable": true,
      "IssuingCountry": null,
      "StartRecurrent": false,
      "Recurring": false,
      "CustomerName": "John Smith",
      "PayerHash": null,
      "PaymentKey": null
   }
}

Capture

The Capture action moves funds for a previously successful Authorize transaction. A full capture or a single partial capture (an amount lower than the originally authorized amount) is supported. Multiple / incremental captures against the same Authorize are NOT supported: once a capture succeeds, the Authorize is no longer capturable.

A Capture does not carry an Apple Pay token. It is identified by OriginalTransactionKey; Buckaroo reloads the card data stored against the original Authorize. PaymentData is therefore not required on a Capture and is ignored if supplied.

Parameters

Basic parameters

ParameterTypeRequiredRecommendedDescription
OriginalTransactionKeyStringYesN/AThe Key of the Authorize transaction to capture against. A 32-character hex string.
AmountDebitNumberYesN/AAmount to capture. Must be greater than zero and not exceed the authorized amount.
CurrencyStringYesN/ACurrency of the capture. The same currency as the Authorize.
InvoiceStringYesN/AMerchant invoice number. May match the Authorize or be a new value.

The Capture action takes no service-specific parameters.

Example request (full capture)

{
   "Currency": "EUR",
   "AmountDebit": 10.00,
   "Invoice": "testinvoice 123",
   "OriginalTransactionKey": "8E04704995B74D679AACC59F87XXXXXX",
   "Services": {
      "ServiceList": [
         {
            "Name": "applepay",
            "Action": "Capture"
         }
      ]
   }
}

Example request (partial capture -- 4.00 EUR of a 10.00 EUR Authorize)

{
   "Currency": "EUR",
   "AmountDebit": 4.00,
   "Invoice": "testinvoice 123",
   "OriginalTransactionKey": "8E04704995B74D679AACC59F87XXXXXX",
   "Services": {
      "ServiceList": [
         {
            "Name": "applepay",
            "Action": "Capture"
         }
      ]
   }
}
⚠️

A second Capture against the same Authorize is rejected -- Apple Pay does not support multiple captures. If you need only part of the funds, send a single partial Capture and release the rest with CancelAuthorize.

Capture Response

Parameters

Service-specific parameters

ParameterTypeRequiredRecommendedDescription
CardNumberEndingStringLast four digits of the card, inherited from the Authorize.
CardExpirationDateStringCard expiry in "yyyy-MM" format.
MaskedCreditcardNumberStringMasked card number.
⚠️

The Status SubCode and the exact output field names below are illustrative; confirm them against a live test response.

Example response

{
   "Key": "C123FD5003FA407297A39C46D0XXXXXX",
   "Status": {
      "Code": {
         "Code": 190,
         "Description": "Success"
      },
      "SubCode": {
         "Code": "S001",
         "Description": "Transaction successfully processed"
      },
      "DateTime": "2026-05-22T17:12:11"
   },
   "RequiredAction": null,
   "Services": [
      {
         "Name": "applepay",
         "Action": null,
         "Parameters": [
            {
               "Name": "CardNumberEnding",
               "Value": "1234"
            },
            {
               "Name": "CardExpirationDate",
               "Value": "2028-09"
            },
            {
               "Name": "MaskedCreditcardNumber",
               "Value": "**** **** **** 1234"
            }
         ]
      }
   ],
   "CustomParameters": null,
   "AdditionalParameters": null,
   "RequestErrors": null,
   "Invoice": "testinvoice 123",
   "ServiceCode": "applepay",
   "IsTest": true,
   "Currency": "EUR",
   "AmountDebit": 10.0,
   "TransactionType": "C520",
   "MutationType": 1,
   "RelatedTransactions": [
      {
         "RelationType": "capture",
         "RelatedTransactionKey": "8E04704995B74D679AACC59F87XXXXXX"
      }
   ],
   "ConsumerMessage": null,
   "Order": null,
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": "John Smith",
   "PayerHash": null,
   "PaymentKey": "9E66009180A245F99987E4972AXXXXXX"
}

Capture Push

Parameters

Service-specific parameters

ParameterTypeRequiredRecommendedDescription
CardNumberEndingStringLast four digits of the card, inherited from the Authorize.
CardExpirationDateStringCard expiry in "yyyy-MM" format.
MaskedCreditcardNumberStringMasked card number.

Example Push

{
   "Transaction": {
      "Key": "C123FD5003FA407297A39C46D0XXXXXX",
      "Invoice": "testinvoice 123",
      "ServiceCode": "applepay",
      "Status": {
         "Code": {
            "Code": 190,
            "Description": "Success"
         },
         "SubCode": {
            "Code": "S001",
            "Description": "Transaction successfully processed"
         },
         "DateTime": "2026-05-22T17:12:11"
      },
      "IsTest": true,
      "Order": null,
      "Currency": "EUR",
      "AmountDebit": 10.0,
      "TransactionType": "C520",
      "Services": [
         {
            "Name": "applepay",
            "Action": null,
            "Parameters": [
               {
                  "Name": "CardNumberEnding",
                  "Value": "1234"
               },
               {
                  "Name": "CardExpirationDate",
                  "Value": "2028-09"
               },
               {
                  "Name": "MaskedCreditcardNumber",
                  "Value": "**** **** **** 1234"
               }
            ],
            "VersionAsProperty": 1
         }
      ],
      "CustomParameters": null,
      "AdditionalParameters": null,
      "MutationType": 1,
      "RelatedTransactions": [
         {
            "RelationType": "capture",
            "RelatedTransactionKey": "8E04704995B74D679AACC59F87XXXXXX"
         }
      ],
      "IsCancelable": false,
      "IssuingCountry": null,
      "StartRecurrent": false,
      "Recurring": false,
      "CustomerName": "John Smith",
      "PayerHash": null,
      "PaymentKey": "9E66009180A245F99987E4972AXXXXXX"
   }
}

CancelAuthorize

The CancelAuthorize action voids an authorization, releasing the reserved funds back to the buyer. It is a "credit"-direction action: supply the amount via AmountCredit, or omit the amount to void the full authorization. After cancellation the authorization can no longer be captured.

Parameters

Basic parameters

ParameterTypeRequiredRecommendedDescription
OriginalTransactionKeyStringYesN/AThe Key of the Authorize transaction to void. A 32-character hex string.
AmountCreditNumberNoN/AAmount to release. If omitted, the full authorized amount is voided.

CancelAuthorize takes no service-specific parameters. The action's direction is "credit", so amounts must be supplied via AmountCredit (or omitted):

  • Omitting the amount is the simplest and recommended way to void the full authorization.
  • AmountDebit is the wrong direction for a Cancel action and is rejected. Use AmountCredit or no amount at all.
⚠️

The exact validation of a supplied AmountCredit (e.g. whether a value below the authorized amount is accepted or whether only a full void is allowed) is illustrative here -- confirm against a live test response.

Example request (no amount -- voids the full authorization)

{
   "OriginalTransactionKey": "8E04704995B74D679AACC59F87XXXXXX",
   "Services": {
      "ServiceList": [
         {
            "Name": "applepay",
            "Action": "CancelAuthorize"
         }
      ]
   }
}

Example request (with AmountCredit)

{
   "Currency": "EUR",
   "AmountCredit": 10.00,
   "OriginalTransactionKey": "8E04704995B74D679AACC59F87XXXXXX",
   "Services": {
      "ServiceList": [
         {
            "Name": "applepay",
            "Action": "CancelAuthorize"
         }
      ]
   }
}

CancelAuthorize Response

⚠️

The Status SubCode below is illustrative; confirm against a live test response.

Example response

{
   "Key": "A99FD5003FA407297A39C46D0XXXXXX",
   "Status": {
      "Code": {
         "Code": 190,
         "Description": "Success"
      },
      "SubCode": {
         "Code": "S001",
         "Description": "Transaction successfully processed"
      },
      "DateTime": "2026-05-22T17:30:00"
   },
   "RequiredAction": null,
   "Services": [
      {
         "Name": "applepay",
         "Action": null,
         "Parameters": []
      }
   ],
   "CustomParameters": null,
   "AdditionalParameters": null,
   "RequestErrors": null,
   "Invoice": "testinvoice 123",
   "ServiceCode": "applepay",
   "IsTest": true,
   "Currency": "EUR",
   "AmountCredit": 10.0,
   "TransactionType": "I037",
   "MutationType": 1,
   "RelatedTransactions": [
      {
         "RelationType": "CancelAuthorize",
         "RelatedTransactionKey": "8E04704995B74D679AACC59F87XXXXXX"
      }
   ],
   "ConsumerMessage": null,
   "Order": null,
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": "John Smith",
   "PayerHash": null,
   "PaymentKey": null
}

CancelAuthorize Push

Example Push

{
   "Transaction": {
      "Key": "A99FD5003FA407297A39C46D0XXXXXX",
      "Invoice": "testinvoice 123",
      "ServiceCode": "applepay",
      "Status": {
         "Code": {
            "Code": 190,
            "Description": "Success"
         },
         "SubCode": {
            "Code": "S001",
            "Description": "Transaction successfully processed"
         },
         "DateTime": "2026-05-22T17:30:00"
      },
      "IsTest": true,
      "Order": null,
      "Currency": "EUR",
      "AmountCredit": 10.0,
      "TransactionType": "I037",
      "Services": [
         {
            "Name": "applepay",
            "Action": null,
            "Parameters": []
         }
      ],
      "CustomParameters": null,
      "AdditionalParameters": null,
      "MutationType": 1,
      "RelatedTransactions": [
         {
            "RelationType": "CancelAuthorize",
            "RelatedTransactionKey": "8E04704995B74D679AACC59F87XXXXXX"
         }
      ],
      "IsCancelable": false,
      "IssuingCountry": null,
      "StartRecurrent": false,
      "Recurring": false,
      "CustomerName": "John Smith",
      "PayerHash": null,
      "PaymentKey": null
   }
}
📘

Output parameters

CancelAuthorize transactions do not carry service-specific output parameters. The voided Authorize is identifiable via the RelatedTransactions block on the response and the push (RelationType "CancelAuthorize" pointing at the original Authorize Key).

Refund

📘

Refund in the Authorize/Capture flow

In the Authorize/Capture flow the OriginalTransactionKey must point at the Capture transaction (not the Authorize), because the funds were moved by the Capture. Pay-flow refunds continue to point at the Pay transaction. PaymentData is not required on a Refund.

Refund Request

Parameters

Service-specific parameters

ParameterTypeRequiredRecommendedDescription
OriginalTransactionKeyStringYesN/ATransaction key of the payment that needs to be refunded. Please note: This is a basic parameter, not a service specific parameter.

Example request

{
   "Currency": "EUR",
   "AmountCredit": 1.00,
   "Invoice": "10000480",
   "OriginalTransactionKey": "XXXXXXXXXXXXXXX",
   "Services": {
      "ServiceList": [
         {
            "Name": "applepay",
            "Action": "refund"
         }
      ]
   }
}

Example request (refund of a Capture)

{
   "Currency": "EUR",
   "AmountCredit": 4.00,
   "Invoice": "testinvoice 123",
   "OriginalTransactionKey": "C123FD5003FA407297A39C46D0XXXXXX",
   "Services": {
      "ServiceList": [
         {
            "Name": "applepay",
            "Action": "Refund"
         }
      ]
   }
}

Refund Response

Example response

{
   "Key": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
   "Status": {
      "Code": {
         "Code": 190,
         "Description": "Success"
      },
      "SubCode": {
         "Code": "S001",
         "Description": "Transaction successfully processed"
      },
      "DateTime": "2019-06-13T09:20:24"
   },
   "RequiredAction": null,
   "Services": null,
   "CustomParameters": null,
   "RequestErrors": null,
   "Invoice": "10000480",
   "ServiceCode": "applepay",
   "IsTest": true,
   "Currency": "EUR",
   "AmountCredit": 1.00,
   "TransactionType": "V188",
   "MutationType": 2,
   "RelatedTransactions": [
      {
         "RelationType": "refund",
         "RelatedTransactionKey": "XXXXXXXXXXXXXXXXXXXXX"
      }
   ],
   "ConsumerMessage": null,
   "Order": null,
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": "XXXXXXXXXXXX",
   "PayerHash": null,
   "PaymentKey": "XXXXXXXXXXXXXXXX"
}

Refund Push

Parameters

Example push

{
   "Key": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
   "Status": {
      "Code": {
         "Code": 190,
         "Description": "Success"
      },
      "SubCode": {
         "Code": "S001",
         "Description": "Transaction successfully processed"
      },
      "DateTime": "2019-06-13T09:20:24"
   },
   "RequiredAction": null,
   "Services": null,
   "CustomParameters": null,
   "RequestErrors": null,
   "Invoice": "10000480",
   "ServiceCode": "applepay",
   "IsTest": true,
   "Currency": "EUR",
   "AmountCredit": 1.00,
   "TransactionType": "V188",
   "MutationType": 2,
   "RelatedTransactions": [
      {
         "RelationType": "refund",
         "RelatedTransactionKey": "XXXXXXXXXXXXXXXXXXXXX"
      }
   ],
   "ConsumerMessage": null,
   "Order": null,
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": "XXXXXXXXXXXX",
   "PayerHash": null,
   "PaymentKey": "XXXXXXXXXXXXXXXX"
}

StartRecurrent & PayRecurrent

StartRecurrent

This request initializes a recurring payment setup for Apple Pay. It creates the initial transaction that can be referenced by future PayRecurrent calls.

Note: The parameter StartRecurrent is required to mark the transaction as the starting point of a recurring payment series.

Example request

{
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "Description": "ApplePay StartRecurrent",
    "Invoice": "ApplePay Invoice test123",
    "StartRecurrent": "true",
    "ContinueOnIncomplete": true,
    "Services": {
        "ServiceList": [
            {
                "Name": "ApplePay",
                "Action": "Pay",
                "Parameters": null
            }
        ]
    }
}

Example response

{
    "Key": "C6DE4463704C4743B421CED62B98905A",
    "Status": {
        "Code": {
            "Code": 790,
            "Description": "Pending input"
        },
        "SubCode": null,
        "DateTime": "2025-10-28T15:36:14"
    },
    "RequiredAction": {
        "RedirectURL": "https://testcheckout.buckaroo.nl/html/redirect.ashx?r=18C196B8A9CB482CB5AAB16A6628D758",
        "RequestedInformation": null,
        "PayRemainderDetails": null,
        "Name": "Redirect",
        "TypeDeprecated": 0
    },
    "Invoice": "ApplePay Invoice test123",
    "ServiceCode": "applepay",
    "IsTest": true,
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "StartRecurrent": true,
    "Recurring": false
}

PayRecurrent

Payment method: Apple Pay
Action: PayRecurrent
Service: applepay

This request is used to perform a recurrent Apple Pay payment using a previously authorized transaction reference.

Example request

{
    "Invoice": "ApplePay test invoice 123",
    "Description": "ApplePay description",
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "ContinueOnIncomplete": true,
    "OriginalTransactionKey": "C6DE4463704C4743B421CED62B98905A",
    "Services": {
        "ServiceList": [
            {
                "Name": "ApplePay",
                "Action": "PayRecurrent"
            }
        ]
    }
}

Note: Parameter OriginalTransactionType is required.

Example response

{
    "Key": "17945D98A38F49879CCDB6D7E9983B76",
    "Status": {
        "Code": {
            "Code": 190,
            "Description": "Success"
        },
        "SubCode": {
            "Code": "S990",
            "Description": "The request was successful."
        },
        "DateTime": "2025-10-28T15:42:42"
    },
    "Services": [
        {
            "Name": "applepay",
            "Action": null,
            "Parameters": [
                {"Name": "CardNumberEnding","Value": "6906"},
                {"Name": "CardExpirationDate","Value": "2031-12"},
                {"Name": "MaskedCreditcardNumber","Value": "427106******6906"}
            ]
        }
    ],
    "Invoice": "ApplePay test invoice 123",
    "ServiceCode": "applepay",
    "IsTest": true,
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "TransactionType": "C042",
    "IssuingCountry": "DE",
    "StartRecurrent": false,
    "Recurring": true,
    "CustomerName": "Zejnel Morina",
    "PaymentKey": "975B56C52C1943198C0F5D89AF793894"
}

Push

Example push

{
  "Transaction": {
    "Key": "A97AAC2701044D1998AD140B5BE5F600",
    "Invoice": "ApplePay test invoice 123",
    "ServiceCode": "applepay",
    "Status": {
      "Code": {"Code": 190,"Description": "Success"},
      "SubCode": {"Code": "S990","Description": "The request was successful."},
      "DateTime": "2025-10-28T15:48:05"
    },
    "IsTest": false,
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "TransactionType": "C042",
    "Services": [
      {"Name": "applepay","Parameters": [
          {"Name": "CardNumberEnding","Value": "6906"},
          {"Name": "CardExpirationDate","Value": "2031-12"},
          {"Name": "MaskedCreditcardNumber","Value": "427106******6906"}
      ],"VersionAsProperty": 1}
    ],
    "IssuingCountry": "DE",
    "StartRecurrent": false,
    "Recurring": true,
    "CustomerName": "Zejnel Morina",
    "PaymentKey": "DD74909221654373821267699E9B3830",
    "Description": "ApplePay description"
  }
}


Did this page help you?