Headless Apple Pay

Whitelist Your API Key & Enable Headless Apple Pay

User Authentication

You can use either of the following authentication options:

User KYC

KYC is a mandatory step in compliance with regulatory requirements. Each user should be KYC Approved. You can use either of the following KYC options:

Generate a quote using the Quote API

Call the Get Quote API to get a quote for the transaction. Pass the apiKey, fiat amount, fiat currency, crypto currency, network, and order type.

A successful response returns a quoteId.

Create a transaction session (using Backend only)

Call the Transaction Session API from your backend using the quoteId and the user’s wallet address. You can optionally pass a config object to customise the look and feel of the Apple Pay component.

A successful response returns a sessionId.

Load the Apple Pay Component via Transak UI SDK

Use the Transak UI SDK to render the Apple Pay component. Pass the sessionId received in previous Step.

$
npm install @transak/ui-components-rn

1
import { TransakApplePay } from ‘@transak/ui-components-rn’;
2
3
<TransakApplePay
4
  sessionId={sessionId} // sessionId from Previous Step
5
  environment={environment} // 'STAGING' | 'PRODUCTION'
6
  onReady={() => {
7
    // Component is ready
8
  }}
9
  onSuccess={({ requestId }) => {
10
    // Payment data captured — use requestId in the next step
11
  }}
12
  onError={({ code }) => {
13
    // Handle error
14
  }}
15
/>

Error codes

The onError callback receives a code value. Use it to handle specific failure scenarios:

Here’s how the Apple Pay module appears :

Process the payment with requestId (using Backend only)

Once the SDK fires onSuccess with a requestId, call the Transaction Process API from your backend to complete the payment and create the order.

A successful response returns the full order details.

Track the requestId (using Backend only)

Call the Transaction Request Status API to check whether the request has been processed. Poll this endpoint after calling the Transaction Process API until the status reaches a terminal state.

Once you receive an orderId, use the Get Order by ID API to fetch full order details.