---
title: "Create an Apple Pay web session"
method: POST
path: "/apple-pay/sessions"
tags: ["Apple Pay"]
---

# Create an Apple Pay web session

`POST /apple-pay/sessions`

Request a new Apple Pay web session. Use this endpoint if you process Apple Pay on the web and:
  - you want to rely on Ryft's Apple Pay processing certificate
  - have an existing integration or want to implement Apple Pay via our API (without using our SDKs)

## Headers

- `Account` string

## Request body

- object — The request body for creating an Apple Pay web session
  - `displayName` string, required — This is the name displayed within the Apple Pay payment sheet. Must contain UTF-8 characters.
  - `domainName` string, required — The domain name you have verified for Apple Pay (omit the protocol). This should match `window.location.hostname`.

## Response `200`

Apple Pay session successfully created

- ApplePayWebSessionResponse
  - `sessionObject` string — The opaque Apple Pay session object. This will be a JSON escaped string. Supply this value to [completeMerchantValidation](https://developer.apple.com/documentation/apple_pay_on_the_web/applepaysession/1778015-completemerchantvalidation)

## Other responses

- `400` — One or more inputs are invalid
- `500` — An unexpected error occurred when executing this request

---

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