---
title: "Create an Apple Pay Session"
method: POST
path: "/apple_pay_sessions"
tags: ["Payment Instruments"]
---

# Create an Apple Pay Session

`POST /apple_pay_sessions`

Create an `apple_pay_session` to process Apple Pay transactions on the web.

To create an Apple Pay Session, pass the unique `validation_url` (provided by Apple) while creating an `apple_pay_sessions` resource. Finix returns a `merchantSession` object that you can use to create a payment. For more information, see [Apple Pay](/guides/online-payments/digital-wallets/apple-pay).

## Headers

- `Finix-Version` string
- `Content-Type` string

## Request body

- CreateApplePaySession
  - `display_name` string — This will be the merchant name shown to users when making a purchase via Apple Pay.
  - `domain` string — The domain (or website) where the buyer is initiating the payment.
  - `merchant_identity` string — The `merchant_identity_id` used when registering the business with Apple Pay through our registration API.
  - `validation_url` string — A unique validation URL that will be provided by the Apple SDK front-end for every payment.

## Response `201`

Apple Pay Session

- PaymentInstrumentApplePaySession
  - `id` string — The ID of the resource.
  - `created_at` string, date-time — Timestamp of when the object was created.
  - `updated_at` string, date-time — Timestamp of when the object was last updated.
  - `session_details` string — Details about the `apple_pay_session` that was created.
  - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.
    - `self` object — Link to the resource that was used in the request.
      - `href` string

## Other responses

- `400` — Bad Request. The server cannot process the request due to malformed syntax or invalid data.
- `401` — Unauthorized. Authentication is required and has failed or has not been provided.
- `403` — Forbidden. The client is authenticated but does not have permission to access the resource.
- `404` — Not Found. The requested resource could not be found on the server.
- `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted.
- `422` — Unprocessable Entity. The syntax of the request content was correct, but the server was unable to process the contained instructions.

---

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