---
title: "Get validated session"
method: POST
path: "/rest/v2/apple/merchants/validation"
tags: ["Apple Pay for Web"]
---

# Get validated session

`POST /rest/v2/apple/merchants/validation`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `public-key`
- TypeScript: <https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/docs/rest/v2/apple/merchants/validation/post.ts> (a function with typed inputs; its response is checked against the schema)

Validate a registered merchant domain and returns an Apple Pay merchant session for initiating Apple Pay web transactions.

## Request body

- ValidateMerchantRequest
  - `initiatedFrom` string, required: The Apple Pay initiative value based on the platform.
  - `validationURL` string, required: The Apple Pay URL used to request a merchant validation session.
  - `domain` string, required: The merchant domain registered with Apple Pay.

## Response `200`

Successfully obtained Apple Pay session from Apple.

- AppleMerchantSessionResponsePayload
  - `merchantSession` string: The merchant session returned by Apple to process an Apple Pay for Web transaction.
  - `payloadType` string: The type of payload returned in the response.

## Other responses

- `400`: Failed to get Apple Pay session from Apple.
- `401`: Authorization is invalid. Check your public-key.

---

[API](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow.md) - [All operations](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/llms.txt) - [OpenAPI document](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/revisions/f37077c24b66?raw)