---
title: "Start Apple Pay session"
method: POST
path: "/processing-terminals/{processingTerminalId}/apple-pay-sessions"
tags: ["applePaySessions"]
---

# Start Apple Pay session

`POST /processing-terminals/{processingTerminalId}/apple-pay-sessions`

Use this method to start an Apple Pay session for your merchant.  

In the response, we return the startSessionObject that you send to Apple when you retrieve the cardholder's encrypted payment details.  

**Note:** For more information about how to integrate with Apple Pay, go to [Apple Pay](https://docs.payroc.com/guides/take-payments/apple-pay).

## Path parameters

- `processingTerminalId` string, required

## Headers

- `Authorization` string, required

## Request body

- ApplePaySessions
  - `appleDomainId` string, required — Unique appleDomainId of the merchant's domain that we assigned when you added their domain to our Self-Care Portal.
  - `appleValidationUrl` string, required — Validation URL from the Apple Pay JS API.

## Response `200`

Successful request. We started the Apple Pay session.

- ApplePayResponseSession
  - `startSessionResponse` string, required — Object that Apple returns when they start the merchant's Apple Pay session. Send the content in this object to Apple to retrieve the cardholder's encrypted payment details.

## Other responses

- `400` — Validation error
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)