---
title: "POST /apple-pay"
method: POST
path: "/apple-pay"
tags: ["ApplePay"]
---

# POST /apple-pay

`POST /apple-pay`

## Request body

- ApplePayCreateRequest
  - `expires_at` string, nullable
  - `apple_payment_data` ApplePayMethodToken
    - `paymentData` PaymentData
      - `data` string, nullable
      - `signature` string, nullable
      - `header` Header
        - `publicKeyHash` string, nullable
        - `ephemeralPublicKey` string, nullable
        - `transactionId` string, nullable
        - `applicationData` string, nullable
      - `version` string, nullable
    - `transactionIdentifier` string, nullable
  - `merchant_registration_id` string, uuid, nullable

## Response `200`

Success

- ApplePayCreateResponse
  - `apple_pay` ApplePayToken
    - `id` string, uuid
    - `type` string, nullable
    - `tenant_id` string, uuid
    - `status` string, nullable
    - `expires_at` string, date-time
    - `created_by` string, uuid, nullable
    - `created_at` string, date-time, nullable
    - `modified_by` string, uuid, nullable
    - `modified_at` string, date-time, nullable
    - `transaction_id` string, nullable
    - `payment_data_type` string, nullable
    - `device_manufacturer_identifier` string, nullable
    - `card` CardDetails
      - `bin` string, nullable
      - `last4` string, nullable
      - `expiration_month` integer, nullable
      - `expiration_year` integer, nullable
      - `brand` string, nullable
      - `funding` string, nullable
      - `authentication` string, nullable
      - `issuer` CardIssuer
        - `country` string, nullable
        - `name` string, nullable
      - `issuer_country` CardIssuerCountry
        - `alpha2` string, nullable
        - `name` string, nullable
        - `numeric` string, nullable
      - `segment` string, nullable
      - `product` CardProduct
        - `code` string, nullable
      - `additional` AdditionalCardDetails[], nullable
        - `brand` string, nullable
        - `funding` string, nullable
        - `authentication` string, nullable
        - `issuer` CardIssuer
          - `country` string, nullable
          - `name` string, nullable
    - `data` unknown
    - `authentication` Authentication
      - `threeds_cryptogram` string, nullable
      - `eci_indicator` string, nullable
      - `authentication_responses` SubmerchantAuthenticationResponse[], nullable
        - `merchant_identifier` string, nullable
        - `authentication_data` string, nullable
        - `transaction_amount` string, nullable
    - `fingerprint` string, nullable
    - `ingest_source` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Client Error

---

[API](https://skmtc.net/basistheory/apis/basis-theory-api.md) · [All operations](https://skmtc.net/basistheory/apis/basis-theory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/basistheory/basis-theory-api/revisions/cbb8e098b560/schema)