---
title: "Create an Apple Pay session"
method: PUT
path: "/v0.2/checkouts/{checkout_id}/apple-pay-session"
tags: ["Checkouts"]
---

# Create an Apple Pay session

`PUT /v0.2/checkouts/{checkout_id}/apple-pay-session`

Creates an Apple Pay merchant session for the specified checkout.

Use this endpoint after the customer selects Apple Pay and before calling
`ApplePaySession.completeMerchantValidation(...)` in the browser.
SumUp validates the merchant session request and returns the Apple Pay
session object that your frontend should pass to Apple's JavaScript API.

## Path parameters

- `checkout_id` string, required

## Request body

- object
  - `context` string, hostname, required — the context to create this apple pay session.
  - `target` string, uri, required — The target url to create this apple pay session.

## Response `200`

Successful request. Returns the Apple Pay merchant session object
that should be forwarded to the Apple Pay JS SDK to complete merchant
validation and continue the payment flow.

- object

## Other responses

- `400` — Bad Request
- `404` — The requested resource does not exist.

---

[API](https://skmtc.net/sumup/apis/sumup-rest-api.md) · [All operations](https://skmtc.net/sumup/apis/sumup-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumup/sumup-rest-api/versions/f50e1dc97523/schema)