Apple Pay

Allow customers to securely make payments using Apple Pay on their iPhone, iPad, or Apple Watch.

Refer to Apple's compatibility documentation to learn which devices support Apple Pay.

Apple Pay is compatible with most VINR products and features. VINR users can accept Apple Pay in iOS applications on iOS 9 and above, and on the web in Safari starting with iOS 10 or macOS Sierra. There are no additional fees to process Apple Pay payments — pricing is the same as for other card transactions.

Apple Pay is available to cardholders at participating banks in supported countries. For more information, refer to Apple's participating banks documentation.

Payment flowAskCopy

When a customer taps the Apple Pay button:

1. The device presents the Apple Pay payment sheet with the stored card.
2. The customer authenticates with Face ID, Touch ID, or passcode.
3. Apple generates a one-time cryptogram and sends it to VINR.
4. VINR decrypts the cryptogram and authorises the payment with the card network.
5. The payment is captured and confirmed; you receive a payment.completed webhook.

The payment_method.card.wallet.type field is set to apple_pay on the resulting payment.

In-app purchase eligibility for Apple PayAskCopy

This guide explains how to configure your app to accept Apple Pay directly for physical goods, services, and other eligible items. VINR processes these payments and you pay only VINR's standard processing fees.

For digital products, content, and subscriptions sold in the United States or European Economic Area (EEA), your app can accept Apple Pay by redirecting to an external payment page. You can use the following payment UIs:

• VINR Checkout
• Web Elements
• Payment Links (best for a limited number of products and prices)

In other regions, your app cannot accept Apple Pay for digital products, content, or subscriptions.

Accept Apple PayAskCopy

VINR offers a variety of methods to add Apple Pay as a payment method. Select the integration method you prefer:

dependencies: [
    .package(
        url: "https://github.com/vinr/vinr-ios-sdk.git",
        from: "1.0.0"
    )
]

import VinrSDK

VinrAPI.defaultPublishableKey = "pk_live_..."

// Register supported networks — add .cartesBancaires only for EUR transactions
let supportedNetworks: [PKPaymentNetwork] = [.visa, .masterCard, .amex]

npm install @vinr/react-native-sdk
# or
yarn add @vinr/react-native-sdk

import { useApplePay, VinrProvider } from '@vinr/react-native-sdk';

function CheckoutButton() {
  const { presentApplePay, confirmApplePayPayment } = useApplePay();

  const pay = async () => {
    const { error } = await presentApplePay({
      cartItems: [{ label: 'Your order', amount: '20.00' }],
      country: 'US',
      currency: 'USD',
    });
    if (!error) {
      await confirmApplePayPayment('pay_...');
    }
  };

  return <Button onPress={pay} title="Buy with Apple Pay" />;
}

Register your domain with Apple PayAskCopy

To use Apple Pay on the web, you must register all domains that show an Apple Pay button with Apple. This includes top-level domains (for example, yourstore.com) and subdomains (for example, shop.yourstore.com), in both production and testing.

VINR handles Apple merchant validation for you, including creating an Apple Merchant ID and Certificate Signing Request. Do not follow the merchant validation process in the Apple Pay documentation directly. Instead, register your domain with VINR:

You can do this on the Payment method domains page in the VINR Dashboard, or via the API using your live secret key:

curl https://api.vinr.com/v1/payment_method_domains \
  -u YOUR_SECRET_KEY: \
  -d "domain_name=example.com"

Do not register the same domain more than once per account.

When using direct charges with Connect, you need to configure the domain for each connected account separately using the API. This is not required for connected accounts using other charge types.

After registering your domains, you can accept live Apple Pay payments on your site.

Recurring paymentsAskCopy

We recommend implementing Apple Pay merchant tokens to enable merchant-initiated transactions (MIT) such as recurring and deferred payments and automatic reloads. Merchant tokens (MPANs) connect your business with your customer's Apple Wallet payment method, work across multiple devices, and keep payment information active when a card is moved to a new device.

Test Apple PayAskCopy

To test Apple Pay, use a real credit card number with your test API keys. VINR recognises that you're in test mode and returns a successful test card token without charging the card.

You cannot save VINR test cards or Apple Pay test cards to an Apple Pay wallet for testing.

If Apple Pay does not appear as a payment option, check that your device and integration meet the requirements listed above.

See alsoAskCopy