react-native-hyperpay-sdk 0.11.0 → 0.14.0

package/README.md

@@ -11,23 +11,25 @@ npm i react-native-hyperpay-sdk
 ## Usage
 
 ```js
-import { setConfig } from "react-native-hyperpay-sdk";
+import hyperPay from 'react-native-hyperpay-sdk'
+
 
 // the firt step , set default configiration 
 // 1- shopperResultURL to redirect to this url after the payment completed
 // 2- select your country code from list
 // 3- merchantIdentifier is for apply pay only 
-setConfig({
+hyperPay.setConfig({
 shopperResultURL:"shopperResultURL",
 countryCode:"SA",
-merchantIdentifier:"merchantIdentifier"
+merchantIdentifier:"merchantIdentifier",
+mode:"TestMode"
 })
 // ...
 // to pay with apple 
-const result = await applePay("CheckoutId")
+const result = await hyperPay.applePay("CheckoutId")
 
 // to pay with any brand
- const result=await createPaymentTransaction(
+ const result=await hyperPay.createPaymentTransaction(
      { paymentBrand: "VISA",
      holderName: "Test Test",
      cardNumber: '4111111111111111',
@@ -37,8 +39,21 @@ const result = await applePay("CheckoutId")
      checkoutID: `${res.data?.checkout_id}`,
      shopperResultURL: "[YOUR_APP_IDENTIFIER]://[URL_SCHEMES]" 
       })
+      
+
+      // get payment status
+ const result=await hyperPay.getPaymentStatus("000.000.000")
+//  result={
+//             "code": "000.000.000",
+//             "description": "Transaction succeeded",
+//             "status": "successfully"
+// }
+```
+
 ```
 
+
+
 ## Contributing
 
 See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.

package/ios/HyperPay.m

@@ -9,19 +9,16 @@ OPPPaymentProvider *provider;
 NSString *shopperResultURL = @"";
 NSString *merchantIdentifier = @"";
 NSString *countryCode = @"";
-NSString *mode=@"Test";
+NSString *mode=@"TestMode";
 
 RCT_EXPORT_MODULE(HyperPay)
 
 -(instancetype)init
 {
   
-
-    
     self = [super init];
     if (self) {
-//      #ifdef DEBUG
-        if ([mode isEqual:@"Test"])
+        if ([mode isEqual:@"TestMode"])
         provider = [OPPPaymentProvider paymentProviderWithMode:OPPProviderModeTest];
         else
         provider = [OPPPaymentProvider paymentProviderWithMode:OPPProviderModeLive];

package/lib/typescript/PaymentStatus.d.ts

@@ -0,0 +1,39 @@
+
+
+export type PaymentStatusType =
+    {
+        code: string,
+        description: string,
+        status: string
+    }
+
+
+export type PaymentStatusesGroups =
+    "successfully" |
+    "manuallyReviewed" |
+    "pending" |
+    "rejection3DsecureAndIntercardRiskChecks" |
+    "rejectionsByTheExternalBank" |
+    "rejectionsDueToCommunicationErrors" |
+    "rejectionsDueToSystemErrors" |
+    "rejectionsDueToErrorInAsynchonousWorkflow" |
+    "softDeclines" |
+    "rejectionsDueToChecksByExternalRiskSystems" |
+    "rejectionsDueToAddressValidation" |
+    "rejectionsDueTo3Dsecure" |
+    "rejectionsDueToBlacklistValidation" |
+    "rejectionsDueToRiskValidation" |
+    "rejectionsDueToConfigurationValidation" |
+    "rejectionsDueToRegistrationValidation" |
+    "rejectionsDueToJobValidation" |
+    "rejectionsDueToReferenceValidation" |
+    "rejectionsDueToFormatValidation" |
+    "rejectionsDueToAddressValidation" |
+    "rejectionsDueToContactValidation" |
+    "rejectionsDueToAccountValidation" |
+    "rejectionsDueToAmountValidation" |
+    "rejectionsDueToRiskManagement" |
+    "chargebackRelatedResultCodes"
+
+export declare function getPaymentStatus(status: string): PaymentStatusType
+

package/lib/typescript/index.d.ts

@@ -12,17 +12,17 @@ export type CreateTransactionResponseType = {
 
 export type ConfigType = {
     shopperResultURL: string
-     /**
-     * required for apple pay
-     */
+    /**
+    * required for apple pay
+    */
     countryCode?: keyof CountryCodes
     /**
      * required for apple pay
      */
     merchantIdentifier?: string
-    
-    mode:"Test"|"Live"
-    
+
+    mode?: "TestMode" | "LiveMode"
+
 }
 
 export type CreateTransactionParams = {
@@ -33,15 +33,13 @@ export type CreateTransactionParams = {
     expiryMonth: string,
     cvv: string,
     checkoutID: string,
-    shopperResultURL: string
+    shopperResultURL?: string
 }
 
 export declare function
     createPaymentTransaction(params: CreateTransactionParams):
     Promise<CreateTransactionResponseType>;
 
-
 export declare function setConfig(params: ConfigType): ConfigType
 
 export declare function applePay(checkoutID: string): Promise<any>;
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-hyperpay-sdk",
-  "version": "0.11.0",
+  "version": "0.14.0",
   "description": "hyperpay",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -14,7 +14,6 @@
     "ios",
     "cpp",
     "react-native-hyperpay-sdk.podspec",
-    "OPPWAMobile-Resources.bundle",
     "OPPWAMobile.framework",
     "!lib/typescript/example",
     "!android/build",

package/src/index.tsx

@@ -1,5 +1,17 @@
-import { NativeModules, Platform } from 'react-native';
-import type { CreateTransactionResponseType, CreateTransactionParams, ConfigType } from '../lib/typescript'
+import {
+  NativeModules,
+  Platform
+} from 'react-native';
+import type {
+  CreateTransactionResponseType,
+  CreateTransactionParams,
+  ConfigType
+} from '../lib/typescript'
+import {
+  getPaymentStatus
+} from './paymentStatus'
+
+
 const LINKING_ERROR =
   `The package 'react-native-hyperpay-sdk' doesn't seem to be linked. Make sure: \n\n` +
   Platform.select({ ios: "- You have run 'pod install'\n", default: '' }) +
@@ -18,7 +30,8 @@ const HyperPay = NativeModules.HyperPay
   );
 
 
-export function createPaymentTransaction(params: CreateTransactionParams): Promise<CreateTransactionResponseType> {
+export function createPaymentTransaction(params: CreateTransactionParams):
+  Promise<CreateTransactionResponseType> {
   return HyperPay.createPaymentTransaction(params);
 }
 
@@ -26,7 +39,14 @@ export function setConfig(params: ConfigType): ConfigType {
   return HyperPay.setConfig(params);
 }
 
-
 export function applePay(checkoutID: string): Promise<any> {
   return HyperPay.applePay(checkoutID);
 }
+
+const hyperpay = {
+  applePay,
+  setConfig,
+  createPaymentTransaction,
+  getPaymentStatus
+}
+export default hyperpay

package/src/paymentStatus/groups.ts

@@ -0,0 +1,37 @@
+import type {
+    PaymentStatusesGroups
+} from "../../lib/typescript/PaymentStatus"
+
+export const groups: {
+    group: PaymentStatusesGroups,
+    reg: RegExp,
+    status: "successfully" | "rejected" | "Chargeback" | "pending"
+}[] =
+    [
+        { group: "successfully", reg: /^(000\.000\.|000\.100\.1|000\.[36])/, status: "successfully" },
+        { group: "manuallyReviewed", reg: /^(000\.400\.0[^3]|000\.400\.[0-1]{2}0)/, status: "successfully" },
+        { group: "pending", reg: /^(000\.200)/, status: "pending" },
+        { group: "pending", reg: /^(800\.400\.5|100\.400\.500)/, status: "pending" },
+        { group: "rejection3DsecureAndIntercardRiskChecks", reg: /^(000\.400\.[1][0-9][1-9]|000\.400\.2)/, status: "rejected" },
+        { group: "rejectionsByTheExternalBank", reg: /^(800\.[17]00|800\.800\.[123])/, status: "rejected" },
+        { group: "rejectionsDueToCommunicationErrors", reg: /^(900\.[1234]00|000\.400\.030)/, status: "rejected" },
+        { group: "rejectionsDueToSystemErrors", reg: /^(800\.[56]|999\.|600\.1|800\.800\.[84])/, status: "rejected" },
+        { group: "rejectionsDueToErrorInAsynchonousWorkflow", reg: /^(100\.39[765])/, status: "rejected" },
+        { group: "softDeclines", reg: /^(300\.100\.100)/, status: "rejected" },
+        { group: "rejectionsDueToChecksByExternalRiskSystems", reg: /^(100\.400\.[0-3]|100\.38|100\.370\.100|100\.370\.11)/, status: "rejected" },
+        { group: "rejectionsDueToAddressValidation", reg: /^(800\.400\.1)/, status: "rejected" },
+        { group: "rejectionsDueTo3Dsecure", reg: /^(800\.400\.2|100\.380\.4|100\.390)/, status: "rejected" },
+        { group: "rejectionsDueToBlacklistValidation", reg: /^(100\.100\.701|800\.[32])/, status: "rejected" },
+        { group: "rejectionsDueToRiskValidation", reg: /^(800\.1[123456]0)/, status: "rejected" },
+        { group: "rejectionsDueToConfigurationValidation", reg: /^(600\.[23]|500\.[12]|800\.121)/, status: "rejected" },
+        { group: "rejectionsDueToRegistrationValidation", reg: /^(100\.[13]50)/, status: "rejected" },
+        { group: "rejectionsDueToJobValidation", reg: /^(100\.250|100\.360)/, status: "rejected" },
+        { group: "rejectionsDueToReferenceValidation", reg: /^(700\.[1345][05]0)/, status: "rejected" },
+        { group: "rejectionsDueToFormatValidation", reg: /^(200\.[123]|100\.[53][07]|800\.900|100\.[69]00\.500)/, status: "rejected" },
+        { group: "rejectionsDueToAddressValidation", reg: /^(100\.800)/, status: "rejected" },
+        { group: "rejectionsDueToContactValidation", reg: /^(100\.[97]00)/, status: "rejected" },
+        { group: "rejectionsDueToAccountValidation", reg: /^(100\.100|100.2[01])/, status: "rejected" },
+        { group: "rejectionsDueToAmountValidation", reg: /^(100\.55)/, status: "rejected" },
+        { group: "rejectionsDueToRiskManagement", reg: /^(100\.380\.[23]|100\.380\.101)/, status: "rejected" },
+        { group: "chargebackRelatedResultCodes", reg: /^(000\.100\.2)/, status: "Chargeback" },
+    ]

package/src/paymentStatus/index.ts

@@ -0,0 +1,21 @@
+import {
+    groups
+} from './groups';
+import type {
+    PaymentStatusType,
+} from '../../lib/typescript/PaymentStatus'
+import {
+    PaymentStatus
+} from './paymentStatus'
+
+export const getPaymentStatus = (code: string): PaymentStatusType => {
+    const selectedGroup = groups.find((group) => group.reg.test(code))
+    if (selectedGroup)
+        return PaymentStatus[selectedGroup.group][code]
+    else
+        return {
+            code,
+            description: "This status code is invalid",
+            status: "error"
+        }
+}