npm - react-native-hyperpay-sdk - Versions diffs - 1.0.6 → 1.0.7 - Mend

react-native-hyperpay-sdk 1.0.6 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +49 -2
package/ios/HyperPay.m +2 -6
package/ios/HyperPaySupportedNetworks.h +14 -0
package/ios/HyperPaySupportedNetworks.m +77 -0
package/lib/typescript/SupportedNetworks.d.ts +34 -21
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -22,6 +22,7 @@ A React Native SDK for integrating [HyperPay](https://www.hyperpay.com/) — a l
   - [Check Payment Status](#check-payment-status)
 - [Track Loading State](#track-loading-state)
 - [Supported Payment Brands](#supported-payment-brands)
+- [Supported Apple Pay Networks](#supported-apple-pay-networks-ios-only)
 - [Android Configuration](#android-configuration-optional)
 - [API Reference](#api-reference)
 - [TypeScript Types](#typescript-types)
@@ -81,7 +82,7 @@ HyperPay.init({
   merchantIdentifier: 'merchant.com.yourapp',      // Apple Pay merchant identifier (iOS only)
   mode: 'TestMode',                                // 'TestMode' | 'LiveMode'
   companyName: 'Your Company',                     // displayed in Apple Pay sheet (iOS only)
-  supportedNetworks: ['visa', 'masterCard'],        // Apple Pay supported networks (iOS only)
+  supportedNetworks: ['Visa', 'MasterCard'],        // Apple Pay supported networks (iOS only)
   currencyCode: 'SAR',                              // ISO 4217 currency code, Apple Pay only (iOS only)
 });
 ```
@@ -95,7 +96,7 @@ HyperPay.init({
 | `merchantIdentifier` | `string`                      | No       | Apple Pay merchant identifier registered in your Apple Developer account (iOS only) |
 | `mode`               | `'TestMode' \| 'LiveMode'`    | No       | Payment environment — defaults to `'TestMode'`                                |
 | `companyName`        | `string`                      | No       | Merchant name displayed in the Apple Pay sheet as "Pay `<companyName>`" (iOS only) |
-| `supportedNetworks`  | `SupportedNetworks[]`         | No       | Card networks accepted by Apple Pay (e.g. `'visa'`, `'masterCard'`, `'mada'`) (iOS only) |
+| `supportedNetworks`  | `SupportedNetworks[]`         | No       | Card networks accepted by Apple Pay (e.g. `'Visa'`, `'MasterCard'`, `'mada'`) — see [Supported Apple Pay Networks](#supported-apple-pay-networks-ios-only) (iOS only) |
 | `currencyCode`       | `string`                      | No       | ISO 4217 currency code (e.g. `'SAR'`, `'USD'`) used for Apple Pay (iOS only)   |
 ---
@@ -238,6 +239,52 @@ For the complete list of 40+ supported brands, see [CardAccountBrands.ts](lib/ty
 ---
+## Supported Apple Pay Networks (iOS Only)
+The `supportedNetworks` config option accepts any value from the `SupportedNetworks` type. Matching is case-insensitive on the native side. A network is only honored if the shopper's device is running an iOS version that supports it — older devices simply ignore networks they don't support.
+| Network           | Minimum iOS | Notes                     |
+|-------------------|-------------|----------------------------|
+| `Visa`            | 8.0         | Global                     |
+| `MasterCard`      | 8.0         | Global                     |
+| `AmEx`            | 8.0         | Global                     |
+| `Discover`        | 9.0         | Global                     |
+| `ChinaUnionPay`   | 9.2         | China                      |
+| `Interac`         | 9.2         | Canada                     |
+| `PrivateLabel`    | 9.0         | —                          |
+| `JCB`             | 10.1        | Japan                      |
+| `Suica`           | 10.1        | Japan (transit)            |
+| `iD`              | 10.3        | Japan                      |
+| `QUICPay`         | 10.3        | Japan                      |
+| `CartesBancaires` | 11.2        | France                     |
+| `Maestro`         | 12.0        | Europe                     |
+| `Electron`        | 12.0        | Global                     |
+| `VPay`            | 12.0        | Europe                     |
+| `Eftpos`          | 12.0        | Australia                  |
+| `mada`            | 12.1.1      | Saudi Arabia (KSA)         |
+| `Elo`             | 12.1.1      | Brazil                     |
+| `Barcode`         | 14.0        | —                          |
+| `Girocard`        | 14.0        | Germany                    |
+| `Mir`             | 14.5        | Russia                     |
+| `WAON`            | 15.0        | Japan                      |
+| `Nanaco`          | 15.0        | Japan                      |
+| `Dankort`         | 15.1        | Denmark                    |
+| `Bancontact`      | 16.0        | Belgium                    |
+| `PostFinance`     | 16.4        | Switzerland                |
+| `PagoBancomat`    | 17.0        | Italy                      |
+| `Tmoney`          | 17.0        | South Korea                |
+| `Meeza`           | 17.4        | Egypt                      |
+| `NAPAS`           | 17.5        | Vietnam                    |
+| `BankAxept`       | 17.5        | Norway                     |
+| `Himyan`          | 18.4        | —                          |
+| `Jaywan`          | 18.4        | United Arab Emirates       |
+| `MyDebit`         | 26.0        | Malaysia                   |
+| `Conecs`          | 26.2        | France                     |
+For the full type definition, see [SupportedNetworks.d.ts](lib/typescript/SupportedNetworks.d.ts).
+---
 ## Android Configuration (Optional)
 To override the default Android SDK build versions used by the library, add the following to your root `android/build.gradle`:

package/ios/HyperPay.m CHANGED Viewed

@@ -1,6 +1,7 @@
 #import <Foundation/Foundation.h>
 #import "HyperPay.h"
+#import "HyperPaySupportedNetworks.h"
 #import <React/RCTLog.h>
 @interface HyperPay ()
@@ -128,12 +129,7 @@ RCT_EXPORT_METHOD(applePay:(NSDictionary*)params resolver:(RCTPromiseResolveBloc
         NSArray *rawNetworks = [params valueForKey:@"supportedNetworks"] ?: supportedNetworks;
         if (rawNetworks.count > 0 && [rawNetworks[0] isKindOfClass:[NSString class]]) {
             NSMutableArray *mapped = [NSMutableArray array];
-            NSDictionary *networkMap = @{
-                @"visa":       PKPaymentNetworkVisa,
-                @"mastercard": PKPaymentNetworkMasterCard,
-                @"amex":       PKPaymentNetworkAmex,
-                @"mada":       PKPaymentNetworkMada,
-            };
+            NSDictionary<NSString *, PKPaymentNetwork> *networkMap = [HyperPaySupportedNetworks map];
             for (NSString *name in rawNetworks) {
                 PKPaymentNetwork net = networkMap[[name lowercaseString]];
                 if (net) [mapped addObject:net];

package/ios/HyperPaySupportedNetworks.h ADDED Viewed

@@ -0,0 +1,14 @@
+#ifndef HyperPaySupportedNetworks_h
+#define HyperPaySupportedNetworks_h
+#import <Foundation/Foundation.h>
+#import <PassKit/PassKit.h>
+@interface HyperPaySupportedNetworks : NSObject
+/// Maps a lowercased network name (e.g. "visa", "mastercard", "mada") to its PKPaymentNetwork constant.
+/// Only includes networks available on the running OS version.
++ (NSDictionary<NSString *, PKPaymentNetwork> *)map;
+@end
+#endif /* HyperPaySupportedNetworks_h */

package/ios/HyperPaySupportedNetworks.m ADDED Viewed

@@ -0,0 +1,77 @@
+#import "HyperPaySupportedNetworks.h"
+@implementation HyperPaySupportedNetworks
++ (NSDictionary<NSString *, PKPaymentNetwork> *)map {
+    NSMutableDictionary<NSString *, PKPaymentNetwork> *map = [NSMutableDictionary dictionary];
+    // Available since iOS 13 (this SDK's minimum deployment target)
+    map[@"amex"]            = PKPaymentNetworkAmex;
+    map[@"cartesbancaires"] = PKPaymentNetworkCartesBancaires;
+    map[@"chinaunionpay"]   = PKPaymentNetworkChinaUnionPay;
+    map[@"discover"]        = PKPaymentNetworkDiscover;
+    map[@"id"]              = PKPaymentNetworkIDCredit;
+    map[@"interac"]         = PKPaymentNetworkInterac;
+    map[@"jcb"]             = PKPaymentNetworkJCB;
+    map[@"mastercard"]      = PKPaymentNetworkMasterCard;
+    map[@"privatelabel"]    = PKPaymentNetworkPrivateLabel;
+    map[@"quicpay"]         = PKPaymentNetworkQuicPay;
+    map[@"suica"]           = PKPaymentNetworkSuica;
+    map[@"visa"]            = PKPaymentNetworkVisa;
+    if (@available(iOS 12.0, *)) {
+        map[@"maestro"]  = PKPaymentNetworkMaestro;
+        map[@"electron"] = PKPaymentNetworkElectron;
+        map[@"vpay"]     = PKPaymentNetworkVPay;
+        map[@"eftpos"]   = PKPaymentNetworkEftpos;
+    }
+    if (@available(iOS 12.1.1, *)) {
+        map[@"mada"] = PKPaymentNetworkMada;
+        map[@"elo"]  = PKPaymentNetworkElo;
+    }
+    if (@available(iOS 14.0, *)) {
+        map[@"barcode"]  = PKPaymentNetworkBarcode;
+        map[@"girocard"] = PKPaymentNetworkGirocard;
+    }
+    if (@available(iOS 14.5, *)) {
+        map[@"mir"] = PKPaymentNetworkMir;
+    }
+    if (@available(iOS 15.0, *)) {
+        map[@"waon"]   = PKPaymentNetworkWaon;
+        map[@"nanaco"] = PKPaymentNetworkNanaco;
+    }
+    if (@available(iOS 15.1, *)) {
+        map[@"dankort"] = PKPaymentNetworkDankort;
+    }
+    if (@available(iOS 16.0, *)) {
+        map[@"bancontact"] = PKPaymentNetworkBancontact;
+    }
+    if (@available(iOS 16.4, *)) {
+        map[@"postfinance"] = PKPaymentNetworkPostFinance;
+    }
+    if (@available(iOS 17.0, *)) {
+        map[@"pagobancomat"] = PKPaymentNetworkPagoBancomat;
+        map[@"tmoney"]       = PKPaymentNetworkTmoney;
+    }
+    if (@available(iOS 17.4, *)) {
+        map[@"meeza"] = PKPaymentNetworkMeeza;
+    }
+    if (@available(iOS 17.5, *)) {
+        map[@"napas"]     = PKPaymentNetworkNAPAS;
+        map[@"bankaxept"] = PKPaymentNetworkBankAxept;
+    }
+    if (@available(iOS 18.4, *)) {
+        map[@"himyan"] = PKPaymentNetworkHimyan;
+        map[@"jaywan"] = PKPaymentNetworkJaywan;
+    }
+    if (@available(iOS 26.0, *)) {
+        map[@"mydebit"] = PKPaymentNetworkMyDebit;
+    }
+    if (@available(iOS 26.2, *)) {
+        map[@"conecs"] = PKPaymentNetworkConecs;
+    }
+    return map;
+}
+@end

package/lib/typescript/SupportedNetworks.d.ts CHANGED Viewed

@@ -1,29 +1,42 @@
+/**
+ * Apple Pay supported card networks (PKPaymentNetwork).
+ * Matching is case-insensitive on the native side.
+ * Networks newer than iOS 13 are only honored on devices running an OS that supports them.
+ */
 export type SupportedNetworks =
-    "mada" |
-    "Visa" |
-    "JCB" |
-    "Elo" |
-    "Mir" |
-    "Suica" |
-    "MasterCard" |
-    "iD" |
-    "CarteBancaires" |
-    "ChinaUnionPay" |
     "AmEx" |
-    "WAON" |
-    "VPay" |
-    "Eftpos" |
-    "nanaco" |
+    "Bancontact" |
+    "BankAxept" |
     "Barcode" |
+    "CartesBancaires" |
+    "ChinaUnionPay" |
+    "Conecs" |
     "Dankort" |
-    "Interac" |
-    "Maestro" |
     "Discover" |
+    "Eftpos" |
     "Electron" |
-    "girocard" |
-    "QUICPay" |
+    "Elo" |
+    "Girocard" |
+    "Himyan" |
+    "iD" |
+    "Interac" |
+    "Jaywan" |
+    "JCB" |
+    "mada" |
+    "Maestro" |
+    "MasterCard" |
+    "Meeza" |
+    "Mir" |
+    "MyDebit" |
+    "Nanaco" |
+    "NAPAS" |
+    "PagoBancomat" |
+    "PostFinance" |
     "PrivateLabel" |
-    "CartesBancaires" |
-    "CarteBancaire"
+    "QUICPay" |
+    "Suica" |
+    "Tmoney" |
+    "Visa" |
+    "VPay" |
+    "WAON"

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "react-native-hyperpay-sdk",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "hyperpay",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",