> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rheon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Apple Pay

> Apple Pay rides the card purchase call. There is no endpoint of its own.

Apple Pay is a payment method on the card rail, not a product with its own
endpoints. A buyer who picks it on the hosted card page goes through exactly the
same four calls as a typed card payment, and nothing in your request says
"Apple Pay":

<Steps>
  <Step title="Price it">
    [`POST /v1/card/quote`](/api-reference/cards/display-quote-for-a-card-purchase)
    with the fiat currency and the amount the buyer pays.
  </Step>

  <Step title="Verify the buyer">
    [`POST /v1/card/kyc-token`](/api-reference/cards/verification-token-for-the-buyer)
    returns the token that opens verification for them.
  </Step>

  <Step title="Start the payment">
    [`POST /v1/card/purchase`](/api-reference/cards/start-a-card-purchase) answers
    `redirectUrl`, the hosted card page. On a supported Apple device that page
    offers Apple Pay next to card entry; the buyer authorises with Face ID or
    Touch ID.
  </Step>

  <Step title="Follow it to settlement">
    [`POST /v1/card/status`](/api-reference/cards/poll-a-card-purchase) until the
    `state` is terminal. The payment method does not change the states you get.
  </Step>
</Steps>

<Note>
  **Provider sandbox on this deployment.** The card calls above target the card
  provider's sandbox: no card is charged and no real transfer settles. Every response
  says which environment answered in its `environment` field.
</Note>

## Native Apple Pay

Native means your own app presents the Apple Pay sheet, with no redirect to a
hosted page. The API has no call for it: it needs a merchant identity and
payment-processing certificates registered with Apple, and each partner
whitelisted on the card partner's Apple account, so talk to us before planning
it. The hosted page needs none of that.

## Which buyers see it

| Condition                                | How to check                                                                    |
| ---------------------------------------- | ------------------------------------------------------------------------------- |
| The country is open on the card rail     | [Card countries](/api-reference/cards/where-a-card-payment-may-not-come-from)   |
| The currency is supported                | [Card currencies](/api-reference/cards/what-a-card-can-pay-in-and-what-it-buys) |
| The device and browser support Apple Pay | Apple's own support, on the buyer's side                                        |

The product story, fees included, is on [Apple Pay](/products/apple-pay).