From 086f978216f8aacd04d67ff24e55a8ceee38ce66 Mon Sep 17 00:00:00 2001
From: Aryeh Stiefel <astiefel@bolt.com>
Date: Fri, 27 Mar 2026 08:14:55 -0400
Subject: [PATCH] docs: add Apple Pay entitlement and Google Pay merchant ID
 prerequisites to README

---
 README.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/README.md b/README.md
index 9d8beea..2a49a08 100644
--- a/README.md
+++ b/README.md
@@ -151,6 +151,28 @@ function StoredCardPayment() {
 
 ### 4. Apple Pay (iOS)
 
+#### Prerequisites
+
+Your app must have the Apple Pay entitlement configured with your Apple-registered merchant identifier. This is **not** your Bolt publishable key — it's the identifier you register in the [Apple Developer portal](https://developer.apple.com/account/resources/identifiers).
+
+**Xcode:** Open your app target → **Signing & Capabilities** → **+ Capability** → **Apple Pay** → check your merchant ID.
+
+**Expo:** Add this to your `app.json`:
+
+```json
+{
+  "ios": {
+    "entitlements": {
+      "com.apple.developer.in-app-payments": ["merchant.com.yourapp"]
+    }
+  }
+}
+```
+
+Then re-run `expo prebuild` and rebuild.
+
+#### Usage
+
 ```typescript
 import { ApplePay } from '@boltpay/react-native/payments';
 
@@ -176,6 +198,12 @@ function CheckoutScreen() {
 
 ### 5. Google Pay (Android)
 
+#### Prerequisites
+
+Your `config.merchantId` must be your Google Pay merchant ID from the [Google Pay Business Console](https://pay.google.com/business/console/). For testing, you can use any value — Google Pay's test environment does not validate the merchant ID.
+
+#### Usage
+
 ```typescript
 import { GoogleWallet } from '@boltpay/react-native/payments';