---
title: "Generate a merchant-session"
method: POST
path: "/payment-methods/apple-pay/session"
tags: ["Payment Methods"]
---

# Generate a merchant-session

`POST /payment-methods/apple-pay/session`

For every new Apple Pay payment request you receive a session object. You must validate your merchant identity in order to generate the merchant-session.

## Headers

- `Company-Id` string, uuid

## Request body

- object
  - `domain` string, required — The domain / subdomain that you are loading the Apple Pay payment sheet from. This must also be registered in the Hub.
  - `display_name` string, required — The name of your store as it will be displayed to the user on the Apple Pay payment sheet.
  - `validation_url` string, uri, required — The URL that your server must use to validate itself and obtain a merchant session object.

## Response `200`

OK

- object
  - `merchant_session` string — At the end of the Apple Pay process, an encrypted payload is returned to your application. The merchant must base64 the payload and submit through to us in the payment.token field of the request.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server error

---

[API](https://skmtc.dev/acquired/apis/acquired-api.md) · [All operations](https://skmtc.dev/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/acquired/acquired-api/revisions/7ae178a046f2/schema)