---end

 Enabling Express Checkout in the Payment Request

---end

In order to retrieve address information that is needed for the express checkout, following configuration steps below.

Add shipping configurations to the payment request

• requiredShippingContactFields
• requiredBillingContactFields.

required contact fields in the payment request

  const paymentRequest = {
        ..., 
      "requiredBillingContactFields": [
        "postalAddress",
        "name"
    ],
    "requiredShippingContactFields": [
        "postalAddress",
        "name",
        "phone",
        "email"
    ],
 };

---end

---end

 Event Handlers for Express Checkout

Apple Pay exposes the following event handlers for Express. They are activated automatically when the corresponding fields are set in the ApplePayPaymentRequest.

Dynamic Shipping Cost Calculation

Both onshippingcontactselected and onshippingmethodselected are used to dynamically update shipping cost and totals :

const newShippingMethods = methods; 
  const selected = newShippingMethods[0];

  const newLineItems = [
    { label: 'Subtotal', amount: '100.00' },
    { label: 'Shipping', amount: selected.amount },
    { label: 'Tax',      amount: tax }
  ];
  const newTotal = {
    label: 'My Store',
    amount: (100 + Number(selected.amount) + Number(tax)).toFixed(2)
  };

Return the corresponding update object to Apple Pay: 

session.completeShippingContactSelection({
  newShippingMethods,
  newTotal,
  newLineItems
});

Defining Shipping Methods

Provide the shippingMethods array in the initial ApplePayPaymentRequest to define the available shipping options.

Each shipping method has the fields:

• identifier — internal ID used to map the selection back to your backend.
• label — display name in the sheet.
• detail — secondary description (e.g., delivery time).
• amount — cost of the option.
• dateComponentsRange (optional) — delivery date estimate shown in the sheet.

The first method in the array is used as the default. The list can be updated dynamically inside onshippingcontactselected (e.g., based on the selected country).

 "shippingMethods": [
        {
            "label": "Free Standard Shipping",
            "amount": "0.00",
            "detail": "Arrives in 5-7 days",
            "identifier": "standardShipping",
            "dateComponentsRange": {
                "startDateComponents": {
                    "years": 2026,
                    "months": 4,
                    "days": 27,
                    "hours": 0
                },
                "endDateComponents": {
                    "years": 2026,
                    "months": 4,
                    "days": 29,
                    "hours": 0
                }
            }
        },
        {
            "label": "Express Shipping",
            "amount": "1.00",
            "detail": "Arrives in 2-3 days",
            "identifier": "expressShipping",
            "dateComponentsRange": {
                "startDateComponents": {
                    "years": 2026,
                    "months": 4,
                    "days": 24,
                    "hours": 0
                },
                "endDateComponents": {
                    "years": 2026,
                    "months": 4,
                    "days": 25,
                    "hours": 0
                }
            }
        }
    ]

Shipping Type

Optional. Customizes the label shown in the payment sheet.

Sample suggestion: 

---end

 Handling the Authorized Payment

After the customer authenticates via Touch ID / Face ID, the onpaymentauthorized event fires and you receive an ApplePayPayment object containing:

• The encrypted payment token (paymentData) — to be forwarded to Payone for Payment processing (Same as for the default integration).
• The billing contact (address + name).
• The shipping contact (address, name, phone, email).
• The selected shipping method.

---end

onpaymentauthorized Sample 

{
  "token": {
    "paymentData": {
      "version": "EC_v1",
      "data": "3+f4oOTwPa6f1UZ6tG...CE=",
      "signature": "MIAGCSqGSIb3DQ...AAAA==",
      "header": {
        "ephemeralPublicKey": "MFkwEK...Md==",
        "publicKeyHash": "l0CnXdMv...D1I=",
        "transactionId": "32b...4f3"
      }
    },
    "paymentMethod": {
      "displayName": "Visa 1234",
      "network": "Visa",
      "type": "debit"
    },
    "transactionIdentifier": "32b...4f3"
  },
  "billingContact": {
    "addressLines": ["1 Street", ""],
    "administrativeArea": "",
    "country": "United Kingdom",
    "countryCode": "GB",
    "familyName": "Appleseed",
    "givenName": "John",
    "locality": "London",
    "postalCode": "AB12 3CD",
    "subAdministrativeArea": "",
    "subLocality": ""
  },
  "shippingContact": {
    "addressLines": ["1 Street", ""],
    "...": "..."
  }
}