---
title: "Authorise Apple Pay payment"
method: POST
path: "/v1/frontend/charges/{chargeId}/wallets/apple"
tags: ["Charge operations"]
---

# Authorise Apple Pay payment

`POST /v1/frontend/charges/{chargeId}/wallets/apple`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `chargeId` string, required

## Request body

- ApplePayAuthRequest
  - `payment_data` string: paymentData of Apple Pay payment token as String. This is de-serialised and decrypted for WorldPay payments. For Stripe payments, the value is passed as is when creating a token
  - `payment_info` ApplePayPaymentInfo, required
    - `brand` string
    - `card_type` 'DEBIT' | 'CREDIT' | 'CREDIT_OR_DEBIT'
    - `cardholder_name` string
    - `display_name` string
    - `email` string
    - `last_digits_card_number` string: last digits card number
    - `network` string
    - `transaction_identifier` string

## Response `200`

OK

## Other responses

- `202`: Accepted - payment has been submitted for authorisation and awaiting response from payment service provider
- `400`: Bad request - invalid payload or the payment has been declined
- `402`: Gateway error
- `404`: Not found
- `422`: Unprocessable Entity - Invalid payload or missing mandatory attributes
- `500`: Internal server error

## Changes

- **2026-10-02** `042ba06d9017`: 3 info
  - removed the `AMOUNT_BELOW_MINIMUM` enum value from the `error_identifier` response property for the response status `400`
  - removed the `AMOUNT_BELOW_MINIMUM` enum value from the `error_identifier` response property for the response status `402`
  - removed the `AMOUNT_BELOW_MINIMUM` enum value from the `error_identifier` response property for the response status `422`
- **2026-10-01** `4e93196bd6aa`: 6 warning
  - added the new `AMOUNT_BELOW_MINIMUM_FOR_ADYEN` enum value to the `error_identifier` response property for the response status `400`
  - added the new `AMOUNT_BELOW_MINIMUM_FOR_ADYEN` enum value to the `error_identifier` response property for the response status `402`
  - added the new `AMOUNT_BELOW_MINIMUM_FOR_ADYEN` enum value to the `error_identifier` response property for the response status `422`
  - added the new `AMOUNT_BELOW_MINIMUM_FOR_STRIPE` enum value to the `error_identifier` response property for the response status `400`
  - …2 more
- **2025-01-16** `c12941ae518b`: 3 warning
  - added the new `AMOUNT_BELOW_MINIMUM` enum value to the `error_identifier` response property for the response status `400`
  - added the new `AMOUNT_BELOW_MINIMUM` enum value to the `error_identifier` response property for the response status `402`
  - added the new `AMOUNT_BELOW_MINIMUM` enum value to the `error_identifier` response property for the response status `422`
- …earlier changes not shown

[Operation history](https://skmtc.dev/government-digital-service/apis/connector-api/changes/v1/frontend/charges/:chargeId/wallets/apple/post.md)

---

[API](https://skmtc.dev/government-digital-service/apis/connector-api.md) - [All operations](https://skmtc.dev/government-digital-service/apis/connector-api/llms.txt) - [OpenAPI document](https://skmtc.dev/government-digital-service/apis/connector-api/revisions/7f294e492d3c?raw)