# Create an Apple Pay web session

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)

Endpoint: POST /apple-pay/sessions
Version: 1.1.0
Security: publicApiKeyAuth, secretApiKeyAuth

## Header parameters:

  - `Account` (string)
    The linked accountId (use this if you are processing Apple Pay directly under a sub account's registered Apple Pay domain)
    Example: "ac_3fe8398f-8cdb-43a3-9be2-806c4f84c327"

## Request fields (application/json):

  - `displayName` (string, required)
    This is the name displayed within the Apple Pay payment sheet. Must contain UTF-8 characters.
    Example: "Ryft Merchandise"

  - `domainName` (string, required)
    The domain name you have verified for Apple Pay (omit the protocol). This should match window.location.hostname.
    Example: "ryftpay.com"

## Response 200 fields (application/json):

  - `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)
    Example: "..."

## Response 400 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"

## Response 500 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"