@jimrising/easymerchantsdk-react-native 2.3.0 → 2.3.1

package/README.md

@@ -19,7 +19,7 @@ Add the EasyMerchant SDK to your `package.json` under `dependencies`:
 
 ```json
 "dependencies": {
-  "@jimrising/easymerchantsdk-react-native": "^2.3.0"
+  "@jimrising/easymerchantsdk-react-native": "^2.3.1"
 }
 ```
 
@@ -157,24 +157,34 @@ The `makePayment` flow requires `apiKey` and `secretKey`. Below is a sample conf
 
 ```javascript
 const configMakePayment = {
-  environment: 'sandbox', // String: 'sandbox' or 'production'
   amount: '5.0', // String or number, must be positive
-  currency: 'usd', // String: currency code, e.g., 'usd'
-  tokenOnly: false, // Boolean: true for tokenization, false for full payment
-  saveCard: true, // Boolean: save card details
-  saveAccount: true, // Boolean: save account details for ACH
-  submitButtonText: 'Submit', // String: payment button text
-  authenticatedACH: true, // Boolean: enable authenticated ACH
-  secureAuthentication: true, // Boolean: enable 3D Secure
-  showReceipt: true, // Boolean: show receipt after payment
-  showDonate: false, // Boolean: show donation option
-  showTotal: true, // Boolean: display total amount
-  showSubmitButton: true, // Boolean: show submit button
-  paymentMethods: ['card', 'ach'], // Array: at least one method ('card', 'ach')
+  appearanceSettings: {
+    bodyBackgroundColor: '#121212', // String: hex color
+    borderRadius: '8', // String: border radius in pixels
+    containerBackgroundColor: '#1E1E1E', // String: hex color
+    fontFamily: '"Inter", sans-serif', // String: font family
+    fontSize: '16', // String: font size in pixels
+    fontWeight: 500, // Number: font weight
+    primaryButtonBackgroundColor: '#2563EB', // String: hex color
+    primaryButtonFontColor: '#FFFFFF', // String: hex color
+    primaryButtonHoverColor: '#1D4ED8', // String: hex color
+    primaryFontColor: '#FFFFFF', // String: hex color
+    secondaryButtonBackgroundColor: '#374151', // String: hex color
+    secondaryButtonFontColor: '#E5E7EB', // String: hex color
+    secondaryButtonHoverColor: '#4B5563', // String: hex color
+    secondaryFontColor: '#B0B0B0', // String: hex color
+    theme: 'light', // String: 'light' or 'dark'
+  },
   apiKey: 'replace-with-api-key', // String: environment-specific API key
-  secretKey: 'replace-with-secret-key', // String: environment-specific secret key
+  authenticatedACH: true, // Boolean: enable authenticated ACH
+  currency: 'usd', // String: currency code, e.g., 'usd'
+  email: 'john.doe@example.com', // String: customer email
+  environment: 'sandbox', // String: 'sandbox' or 'production'
   fields: {
-    visibility: { billing: false, additional: false }, // Object: field visibility
+    additional: [
+      { name: 'phone_number', required: false, value: '+1-555-123-4567' },
+      { name: 'description', required: true, value: 'Test payment for development purposes' }
+    ],
     billing: [
       { name: 'address', required: true, value: '123 Main Street, Suite 100' },
       { name: 'country', required: true, value: 'United States' },
@@ -182,48 +192,39 @@ const configMakePayment = {
       { name: 'city', required: false, value: 'San Francisco' },
       { name: 'postal_code', required: true, value: '94105' }
     ],
-    additional: [
-      { name: 'phone_number', required: false, value: '+1-555-123-4567' },
-      { name: 'description', required: true, value: 'Test payment for development purposes' }
-    ]
+    visibility: { additional: false, billing: false }, // Object: field visibility
   },
-  appearanceSettings: {
-    theme: 'light', // String: 'light' or 'dark'
-    bodyBackgroundColor: '#121212', // String: hex color
-    containerBackgroundColor: '#1E1E1E', // String: hex color
-    primaryFontColor: '#FFFFFF', // String: hex color
-    secondaryFontColor: '#B0B0B0', // String: hex color
-    primaryButtonBackgroundColor: '#2563EB', // String: hex color
-    primaryButtonHoverColor: '#1D4ED8', // String: hex color
-    primaryButtonFontColor: '#FFFFFF', // String: hex color
-    secondaryButtonBackgroundColor: '#374151', // String: hex color
-    secondaryButtonHoverColor: '#4B5563', // String: hex color
-    secondaryButtonFontColor: '#E5E7EB', // String: hex color
-    borderRadius: '8', // String: border radius in pixels
-    fontSize: '16', // String: font size in pixels
-    fontWeight: 500, // Number: font weight
-    fontFamily: '"Inter", sans-serif' // String: font family
+  grailPayParams: {
+    brandingName: 'Lyfecycle Payments', // String: branding name
+    finderSubtitle: 'Search for your bank', // String: bank finder subtitle
+    role: 'business', // String: GrailPay role
+    searchPlaceholder: 'Enter bank name', // String: search placeholder
+    timeout: 10, // Number: timeout in seconds
   },
-  email: 'john.doe@example.com', // String: customer email
-  name: 'John Doe', // String: customer name
   isEmail: true, // Boolean: allow email editing
+  is_recurring: false, // Boolean: enable recurring payments
   metadata: {
     metadataOne: 'metadataOne', // String: custom metadata
     metadataTwo: 'metadataTwo' // String: custom metadata
   },
-  grailPayParams: {
-    role: 'business', // String: GrailPay role
-    timeout: 10, // Number: timeout in seconds
-    brandingName: 'Lyfecycle Payments', // String: branding name
-    finderSubtitle: 'Search for your bank', // String: bank finder subtitle
-    searchPlaceholder: 'Enter bank name' // String: search placeholder
-  },
-  is_recurring: false, // Boolean: enable recurring payments
-  numOfCycle: 2,  // if is_recurring == true
+  name: 'John Doe', // String: customer name
+  numOfCycle: 2, // if is_recurring == true
+  paymentMethods: ['card', 'ach'], // Array: at least one method ('card', 'ach')
   recurringIntervals: ['daily', 'weekly', 'monthly'], // if is_recurring == true
+  recurringStartDate: 'dd/MM/yyyy', // must be today  // required if is_recurring == true  
   recurringStartDateType: 'fixed', // if is_recurring == true
-  recurringStartDate: '02/09/2025' // if is_recurring == true
+  saveAccount: true, // Boolean: save account details for ACH
+  saveCard: true, // Boolean: save card details
+  secretKey: 'replace-with-secret-key', // String: environment-specific secret key
+  secureAuthentication: true, // Boolean: enable 3D Secure
+  showDonate: false, // Boolean: show donation option
+  showReceipt: true, // Boolean: show receipt after payment
+  showSubmitButton: true, // Boolean: show submit button
+  showTotal: true, // Boolean: display total amount
+  submitButtonText: 'Submit', // String: payment button text
+  tokenOnly: false, // Boolean: true for tokenization, false for full payment
 };
+
 ```
 
 #### Configuration for `makePaymentV2`
@@ -232,21 +233,33 @@ The `makePaymentV2` flow requires a `clientToken` and omits `apiKey` and `secret
 
 ```javascript
 const configMakePaymentV2 = {
-  environment: 'sandbox', // String: 'sandbox' or 'production'
-  currency: 'usd', // String: currency code, e.g., 'usd'
-  saveCard: true, // Boolean: save card details
-  saveAccount: true, // Boolean: save account details for ACH
-  submitButtonText: 'Submit', // String: payment button text
+  appearanceSettings: {
+    bodyBackgroundColor: '#121212', // String: hex color
+    borderRadius: '8', // String: border radius in pixels
+    containerBackgroundColor: '#1E1E1E', // String: hex color
+    fontFamily: '"Inter", sans-serif', // String: font family
+    fontSize: '16', // String: font size in pixels
+    fontWeight: 500, // Number: font weight
+    primaryButtonBackgroundColor: '#2563EB', // String: hex color
+    primaryButtonFontColor: '#FFFFFF', // String: hex color
+    primaryButtonHoverColor: '#1D4ED8', // String: hex color
+    primaryFontColor: '#FFFFFF', // String: hex color
+    secondaryButtonBackgroundColor: '#374151', // String: hex color
+    secondaryButtonFontColor: '#E5E7EB', // String: hex color
+    secondaryButtonHoverColor: '#4B5563', // String: hex color
+    secondaryFontColor: '#B0B0B0', // String: hex color
+    theme: 'light', // String: 'light' or 'dark'
+  },
   authenticatedACH: true, // Boolean: enable authenticated ACH
-  secureAuthentication: true, // Boolean: enable 3D Secure
-  showReceipt: true, // Boolean: show receipt after payment
-  showDonate: false, // Boolean: show donation option
-  showTotal: true, // Boolean: display total amount
-  showSubmitButton: true, // Boolean: show submit button
-  paymentMethods: ['card', 'ach'], // Array: at least one method ('card', 'ach')
   clientToken: 'replace-with-client-token', // String: client token from payment intent API
+  currency: 'usd', // String: currency code, e.g., 'usd'
+  email: 'john.doe@example.com', // String: customer email
+  environment: 'sandbox', // String: 'sandbox' or 'production'
   fields: {
-    visibility: { billing: false, additional: false }, // Object: field visibility
+    additional: [
+      { name: 'phone_number', required: false, value: '+1-555-123-4567' },
+      { name: 'description', required: true, value: 'Test payment for development purposes' }
+    ],
     billing: [
       { name: 'address', required: true, value: '123 Main Street, Suite 100' },
       { name: 'country', required: true, value: 'United States' },
@@ -254,42 +267,30 @@ const configMakePaymentV2 = {
       { name: 'city', required: false, value: 'San Francisco' },
       { name: 'postal_code', required: true, value: '94105' }
     ],
-    additional: [
-      { name: 'phone_number', required: false, value: '+1-555-123-4567' },
-      { name: 'description', required: true, value: 'Test payment for development purposes' }
-    ]
+    visibility: { additional: false, billing: false }, // Object: field visibility
   },
-  appearanceSettings: {
-    theme: 'light', // String: 'light' or 'dark'
-    bodyBackgroundColor: '#121212', // String: hex color
-    containerBackgroundColor: '#1E1E1E', // String: hex color
-    primaryFontColor: '#FFFFFF', // String: hex color
-    secondaryFontColor: '#B0B0B0', // String: hex color
-    primaryButtonBackgroundColor: '#2563EB', // String: hex color
-    primaryButtonHoverColor: '#1D4ED8', // String: hex color
-    primaryButtonFontColor: '#FFFFFF', // String: hex color
-    secondaryButtonBackgroundColor: '#374151', // String: hex color
-    secondaryButtonHoverColor: '#4B5563', // String: hex color
-    secondaryButtonFontColor: '#E5E7EB', // String: hex color
-    borderRadius: '8', // String: border radius in pixels
-    fontSize: '16', // String: font size in pixels
-    fontWeight: 500, // Number: font weight
-    fontFamily: '"Inter", sans-serif' // String: font family
+  grailPayParams: {
+    brandingName: 'Lyfecycle Payments', // String: branding name
+    finderSubtitle: 'Search for your bank', // String: bank finder subtitle
+    role: 'business', // String: GrailPay role
+    searchPlaceholder: 'Enter bank name', // String: search placeholder
+    timeout: 10, // Number: timeout in seconds
   },
-  email: 'john.doe@example.com', // String: customer email
-  name: 'John Doe', // String: customer name
   isEmail: true, // Boolean: allow email editing
   metadata: {
     metadataOne: 'metadataOne', // String: custom metadata
-    metadataTwo: 'metadataTwo' // String: custom metadata
-  },
-  grailPayParams: {
-    role: 'business', // String: GrailPay role
-    timeout: 10, // Number: timeout in seconds
-    brandingName: 'Lyfecycle Payments', // String: branding name
-    finderSubtitle: 'Search for your bank', // String: bank finder subtitle
-    searchPlaceholder: 'Enter bank name' // String: search placeholder
+    metadataTwo: 'metadataTwo', // String: custom metadata
   },
+  name: 'John Doe', // String: customer name
+  paymentMethods: ['card', 'ach'], // Array: at least one method ('card', 'ach')
+  saveAccount: true, // Boolean: save account details for ACH
+  saveCard: true, // Boolean: save card details
+  secureAuthentication: true, // Boolean: enable 3D Secure
+  showDonate: false, // Boolean: show donation option
+  showReceipt: true, // Boolean: show receipt after payment
+  showSubmitButton: true, // Boolean: show submit button
+  showTotal: true, // Boolean: display total amount
+  submitButtonText: 'Submit', // String: payment button text
 };
 ```
 

package/ios/easymerchantsdk.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = 'easymerchantsdk'
-  s.version          = '2.3.0'
+  s.version          = '2.3.1'
   s.summary          = 'A React Native SDK for Easy Merchant.'
   s.description      = <<-DESC
     A React Native SDK to enable Easy Merchant functionality in mobile applications.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jimrising/easymerchantsdk-react-native",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "",
   "main": "index.js",
   "scripts": {