diff --git a/.gradle/8.0/dependencies-accessors/dependencies-accessors.lock b/.gradle/8.0/dependencies-accessors/dependencies-accessors.lock
index 14b7db9..f61b7c2 100644
Binary files a/.gradle/8.0/dependencies-accessors/dependencies-accessors.lock and b/.gradle/8.0/dependencies-accessors/dependencies-accessors.lock differ
diff --git a/.gradle/buildOutputCleanup/cache.properties b/.gradle/buildOutputCleanup/cache.properties
index 5d761ea..e2dcaa8 100644
--- a/.gradle/buildOutputCleanup/cache.properties
+++ b/.gradle/buildOutputCleanup/cache.properties
@@ -1,2 +1,2 @@
-#Thu Oct 26 10:40:23 AST 2023
+#Thu Oct 26 15:30:33 AST 2023
 gradle.version=8.0
diff --git a/.idea/.gitignore b/.idea/.gitignore
deleted file mode 100644
index 26d3352..0000000
--- a/.idea/.gitignore
+++ /dev/null
@@ -1,3 +0,0 @@
-# Default ignored files
-/shelf/
-/workspace.xml
diff --git a/.idea/compiler.xml b/.idea/compiler.xml
index b589d56..fb7f4a8 100644
--- a/.idea/compiler.xml
+++ b/.idea/compiler.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="CompilerConfiguration">
-    <bytecodeTargetLevel target="17" />
+    <bytecodeTargetLevel target="11" />
   </component>
 </project>
\ No newline at end of file
diff --git a/.idea/copyright/AhlaamK.xml b/.idea/copyright/AhlaamK.xml
deleted file mode 100644
index 12854fe..0000000
--- a/.idea/copyright/AhlaamK.xml
+++ /dev/null
@@ -1,7 +0,0 @@
-<component name="CopyrightManager">
-  <copyright>
-    <option name="allowReplaceRegexp" value="Copyright" />
-    <option name="notice" value="/**&#10; * Created by AhlaamK on &amp;#36;today&#10; * Copyright (c) &amp;#36;today.year . All rights reserved Tap Payments.&#10; * &#10; */" />
-    <option name="myName" value="AhlaamK" />
-  </copyright>
-</component>
\ No newline at end of file
diff --git a/.idea/copyright/profiles_settings.xml b/.idea/copyright/profiles_settings.xml
deleted file mode 100644
index f8f82f8..0000000
--- a/.idea/copyright/profiles_settings.xml
+++ /dev/null
@@ -1,7 +0,0 @@
-<component name="CopyrightManager">
-  <settings default="AhlaamK">
-    <module2copyright>
-      <element module="Project Files" copyright="AhlaamK" />
-    </module2copyright>
-  </settings>
-</component>
\ No newline at end of file
diff --git a/.idea/gradle.xml b/.idea/gradle.xml
index 6d47847..3400d18 100644
--- a/.idea/gradle.xml
+++ b/.idea/gradle.xml
@@ -1,13 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
-  <component name="GradleMigrationSettings" migrationVersion="1" />
   <component name="GradleSettings">
     <option name="linkedExternalProjectsSettings">
       <GradleProjectSettings>
         <option name="testRunner" value="GRADLE" />
         <option name="distributionType" value="DEFAULT_WRAPPED" />
         <option name="externalProjectPath" value="$PROJECT_DIR$" />
-        <option name="gradleJvm" value="jbr-17" />
+        <option name="gradleJvm" value="#JAVA_HOME" />
         <option name="modules">
           <set>
             <option value="$PROJECT_DIR$" />
diff --git a/.idea/misc.xml b/.idea/misc.xml
index 4412b1a..cb1a633 100644
--- a/.idea/misc.xml
+++ b/.idea/misc.xml
@@ -1,10 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ExternalStorageConfigurationManager" enabled="true" />
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_17_PREVIEW" project-jdk-name="jbr-17" project-jdk-type="JavaSDK">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_11" default="true" project-jdk-name="11" project-jdk-type="JavaSDK">
     <output url="file://$PROJECT_DIR$/build/classes" />
   </component>
-  <component name="ProjectType">
-    <option name="id" value="Android" />
-  </component>
 </project>
\ No newline at end of file
diff --git a/.idea/vcs.xml b/.idea/vcs.xml
deleted file mode 100644
index 35eb1dd..0000000
--- a/.idea/vcs.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="" vcs="Git" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/workspace.xml b/.idea/workspace.xml
new file mode 100644
index 0000000..18cbbbb
--- /dev/null
+++ b/.idea/workspace.xml
@@ -0,0 +1,166 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="14802ee0-ba66-4d91-be76-302fa753c99e" name="Changes" comment="">
+      <change beforePath="$PROJECT_DIR$/.gradle/8.0/checksums/checksums.lock" beforeDir="false" afterPath="$PROJECT_DIR$/.gradle/8.0/checksums/checksums.lock" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/8.0/checksums/md5-checksums.bin" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/8.0/checksums/sha1-checksums.bin" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/8.0/dependencies-accessors/dependencies-accessors.lock" beforeDir="false" afterPath="$PROJECT_DIR$/.gradle/8.0/dependencies-accessors/dependencies-accessors.lock" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/8.0/executionHistory/executionHistory.bin" beforeDir="false" afterPath="$PROJECT_DIR$/.gradle/8.0/executionHistory/executionHistory.bin" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/8.0/executionHistory/executionHistory.lock" beforeDir="false" afterPath="$PROJECT_DIR$/.gradle/8.0/executionHistory/executionHistory.lock" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/8.0/fileHashes/fileHashes.bin" beforeDir="false" afterPath="$PROJECT_DIR$/.gradle/8.0/fileHashes/fileHashes.bin" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/8.0/fileHashes/fileHashes.lock" beforeDir="false" afterPath="$PROJECT_DIR$/.gradle/8.0/fileHashes/fileHashes.lock" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/8.0/fileHashes/resourceHashesCache.bin" beforeDir="false" afterPath="$PROJECT_DIR$/.gradle/8.0/fileHashes/resourceHashesCache.bin" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/buildOutputCleanup/buildOutputCleanup.lock" beforeDir="false" afterPath="$PROJECT_DIR$/.gradle/buildOutputCleanup/buildOutputCleanup.lock" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/buildOutputCleanup/cache.properties" beforeDir="false" afterPath="$PROJECT_DIR$/.gradle/buildOutputCleanup/cache.properties" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/buildOutputCleanup/outputFiles.bin" beforeDir="false" afterPath="$PROJECT_DIR$/.gradle/buildOutputCleanup/outputFiles.bin" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gradle/file-system.probe" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/.gitignore" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/compiler.xml" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/copyright/AhlaamK.xml" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/copyright/profiles_settings.xml" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/gradle.xml" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/kotlinc.xml" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/misc.xml" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/vcs.xml" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/app/src/main/java/company/tap/paybutton/MainActivity.kt" beforeDir="false" afterPath="$PROJECT_DIR$/app/src/main/java/company/tap/paybutton/MainActivity.kt" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/app/src/main/res/layout/activity_main.xml" beforeDir="false" afterPath="$PROJECT_DIR$/app/src/main/res/layout/activity_main.xml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/local.properties" beforeDir="false" afterPath="$PROJECT_DIR$/local.properties" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/tappaybutton/build.gradle.kts" beforeDir="false" afterPath="$PROJECT_DIR$/tappaybutton/build.gradle.kts" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/tappaybutton/src/androidTest/java/com/example/tappaybutton/ExampleInstrumentedTest.kt" beforeDir="false" afterPath="$PROJECT_DIR$/tappaybutton/src/androidTest/java/com/example/tappaybutton/ExampleInstrumentedTest.kt" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/tappaybutton/src/main/java/com/example/tappaybutton/PayButton.kt" beforeDir="false" afterPath="$PROJECT_DIR$/tappaybutton/src/main/java/company/tap/tappaybutton/PayButton.kt" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/tappaybutton/src/main/java/com/example/tappaybutton/PayButtonStatusDelegate.kt" beforeDir="false" afterPath="$PROJECT_DIR$/tappaybutton/src/main/java/company/tap/tappaybutton/PayButtonStatusDelegate.kt" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/tappaybutton/src/main/java/com/example/tappaybutton/PayButtonType.kt" beforeDir="false" afterPath="$PROJECT_DIR$/tappaybutton/src/main/java/company/tap/tappaybutton/PayButtonType.kt" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/tappaybutton/src/test/java/com/example/tappaybutton/ExampleUnitTest.kt" beforeDir="false" afterPath="$PROJECT_DIR$/tappaybutton/src/test/java/com/example/tappaybutton/ExampleUnitTest.kt" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="ExecutionTargetManager" SELECTED_TARGET="device_and_snapshot_combo_box_target[5200345652f5b40f]" />
+  <component name="ExternalProjectsData">
+    <projectState path="$PROJECT_DIR$">
+      <ProjectState />
+    </projectState>
+  </component>
+  <component name="ExternalProjectsManager">
+    <system id="GRADLE">
+      <state>
+        <projects_view>
+          <tree_state>
+            <expand>
+              <path>
+                <item name="" type="6a2764b6:ExternalProjectsStructure$RootNode" />
+                <item name="Pay-Button-Android" type="f1a62948:ProjectNode" />
+              </path>
+            </expand>
+            <select />
+          </tree_state>
+        </projects_view>
+      </state>
+    </system>
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="MarkdownSettingsMigration">
+    <option name="stateVersion" value="1" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "android-custom-view/Users/akazi/Documents/TapProjects/Pay-Button-Android/tappaybutton/src/main/java/company/tap/tappaybutton/PayButton.kt_SELECTED": "PayButton",
+    "dart.analysis.tool.window.visible": "false"
+  }
+}]]></component>
+  <component name="RunManager">
+    <configuration name="app" type="AndroidRunConfigurationType" factoryName="Android App">
+      <module name="Pay-Button-Android.app.main" />
+      <option name="DEPLOY" value="true" />
+      <option name="DEPLOY_APK_FROM_BUNDLE" value="false" />
+      <option name="DEPLOY_AS_INSTANT" value="false" />
+      <option name="ARTIFACT_NAME" value="" />
+      <option name="PM_INSTALL_OPTIONS" value="" />
+      <option name="ALL_USERS" value="false" />
+      <option name="ALWAYS_INSTALL_WITH_PM" value="false" />
+      <option name="CLEAR_APP_STORAGE" value="false" />
+      <option name="ACTIVITY_EXTRA_FLAGS" value="" />
+      <option name="MODE" value="default_activity" />
+      <option name="CLEAR_LOGCAT" value="false" />
+      <option name="SHOW_LOGCAT_AUTOMATICALLY" value="false" />
+      <option name="INSPECTION_WITHOUT_ACTIVITY_RESTART" value="false" />
+      <option name="TARGET_SELECTION_MODE" value="DEVICE_AND_SNAPSHOT_COMBO_BOX" />
+      <option name="SELECTED_CLOUD_MATRIX_CONFIGURATION_ID" value="-1" />
+      <option name="SELECTED_CLOUD_MATRIX_PROJECT_ID" value="" />
+      <option name="DEBUGGER_TYPE" value="Auto" />
+      <Auto>
+        <option name="USE_JAVA_AWARE_DEBUGGER" value="false" />
+        <option name="SHOW_STATIC_VARS" value="true" />
+        <option name="WORKING_DIR" value="" />
+        <option name="TARGET_LOGGING_CHANNELS" value="lldb process:gdb-remote packets" />
+        <option name="SHOW_OPTIMIZED_WARNING" value="true" />
+        <option name="ATTACH_ON_WAIT_FOR_DEBUGGER" value="false" />
+        <option name="DEBUG_SANDBOX_SDK" value="false" />
+      </Auto>
+      <Hybrid>
+        <option name="USE_JAVA_AWARE_DEBUGGER" value="false" />
+        <option name="SHOW_STATIC_VARS" value="true" />
+        <option name="WORKING_DIR" value="" />
+        <option name="TARGET_LOGGING_CHANNELS" value="lldb process:gdb-remote packets" />
+        <option name="SHOW_OPTIMIZED_WARNING" value="true" />
+        <option name="ATTACH_ON_WAIT_FOR_DEBUGGER" value="false" />
+        <option name="DEBUG_SANDBOX_SDK" value="false" />
+      </Hybrid>
+      <Java>
+        <option name="ATTACH_ON_WAIT_FOR_DEBUGGER" value="false" />
+        <option name="DEBUG_SANDBOX_SDK" value="false" />
+      </Java>
+      <Native>
+        <option name="USE_JAVA_AWARE_DEBUGGER" value="false" />
+        <option name="SHOW_STATIC_VARS" value="true" />
+        <option name="WORKING_DIR" value="" />
+        <option name="TARGET_LOGGING_CHANNELS" value="lldb process:gdb-remote packets" />
+        <option name="SHOW_OPTIMIZED_WARNING" value="true" />
+        <option name="ATTACH_ON_WAIT_FOR_DEBUGGER" value="false" />
+        <option name="DEBUG_SANDBOX_SDK" value="false" />
+      </Native>
+      <Profilers>
+        <option name="ADVANCED_PROFILING_ENABLED" value="false" />
+        <option name="STARTUP_PROFILING_ENABLED" value="false" />
+        <option name="STARTUP_CPU_PROFILING_ENABLED" value="false" />
+        <option name="STARTUP_CPU_PROFILING_CONFIGURATION_NAME" value="Java/Kotlin Method Sample (legacy)" />
+        <option name="STARTUP_NATIVE_MEMORY_PROFILING_ENABLED" value="false" />
+        <option name="NATIVE_MEMORY_SAMPLE_RATE_BYTES" value="2048" />
+      </Profilers>
+      <option name="DEEP_LINK" value="" />
+      <option name="ACTIVITY_CLASS" value="" />
+      <option name="SEARCH_ACTIVITY_IN_GLOBAL_SCOPE" value="false" />
+      <option name="SKIP_ACTIVITY_VALIDATION" value="false" />
+      <method v="2">
+        <option name="Android.Gradle.BeforeRunTask" enabled="true" />
+      </method>
+    </configuration>
+  </component>
+  <component name="TaskManager">
+    <servers />
+  </component>
+  <component name="XDebuggerManager">
+    <breakpoint-manager>
+      <breakpoints>
+        <line-breakpoint enabled="true" type="kotlin-line">
+          <url>file://$PROJECT_DIR$/app/src/main/java/company/tap/paybutton/MainActivity.kt</url>
+          <line>206</line>
+          <option name="timeStamp" value="1" />
+        </line-breakpoint>
+        <line-breakpoint enabled="true" type="kotlin-line">
+          <url>file://$PROJECT_DIR$/app/src/main/java/company/tap/paybutton/MainActivity.kt</url>
+          <line>168</line>
+          <option name="timeStamp" value="3" />
+        </line-breakpoint>
+      </breakpoints>
+    </breakpoint-manager>
+  </component>
+</project>
\ No newline at end of file
diff --git a/README.md b/README.md
index 2d068f9..68675e7 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,1126 @@
 # Pay-Button-Android
-Generic PayButtons SDK 
+Integrating  Pay-Button-Android SDK in your application
+
+# Introduction
+Before diving into the development process, it's essential to establish the prerequisites and criteria necessary for a successful build. In this step, we'll outline the specific Android requirements, including the minimum SDK version and other important details you need to consider. Let's ensure your project is set up for success from the very beginning.
+
+[![Platform](https://img.shields.io/badge/platform-Android-inactive.svg?style=flat)](https://tap-payments.github.io/goSellSDK-Android/)
+[![Documentation](https://img.shields.io/badge/documentation-100%25-bright%20green.svg)](https://tap-payments.github.io/goSellSDK-Android/)
+[![SDK Version](https://img.shields.io/badge/minSdkVersion-24-blue.svg)](https://stuff.mit.edu/afs/sipb/project/android/docs/reference/packages.html)
+[![SDK Version](https://img.shields.io/badge/targetSdkVersion-33-informational.svg)](https://stuff.mit.edu/afs/sipb/project/android/docs/reference/packages.html)
+[![SDK Version](https://img.shields.io/badge/latestVersion-0.0.3-informational.svg)](https://stuff.mit.edu/afs/sipb/project/android/docs/reference/packages.html)
+
+
+
+# Step 1 :Requirements
+
+ 1. We support from Android minSdk 24
+ 2. Kotlin support version 1.8.0+
+
+# Step 2 :Get Your Public Keys
+
+ While you can certainly use the sandbox keys available within our sample app which you can get by following
+ [installation page](https://developers.tap.company/docs/](https://developers.tap.company/docs/benefit-pay-ios#step-3-installation-using-gradle)),
+ however, we highly recommend visiting our [onboarding page](https://register.tap.company/sell](https://register.tap.company/ae/en/sell)), there you'll have the opportunity to register your package name and acquire your essential Tap Key for activating PayButton  integration.
+
+# Step 3 :Installation
+
+## Gradle
+
+in project module gradle 
+
+```kotlin
+allprojects {
+    repositories {
+        google()
+        jcenter()
+        maven { url 'https://jitpack.io' }
+    }
+}
+```
+
+Then get latest dependency  in your app module gradle
+```kotlin
+dependencies {
+  implementation : 'com.github.Tap-Payments:PayButton-Android:{latest-tag-release}'
+}
+```
+
+# Step 4 :Integrating Pay-Button-Android
+This integration offers two distinct options: a [simple integration](https://register.tap.company/sell) designed for rapid development and streamlined merchant requirements, and an [advanced integration](https://register.tap.company/sell) that adds extra features for a more dynamic payment integration experience.
+
+# Integration Flow
+Noting that in Android, you have the ability to create the UI part of the PayButton-Android by creating it as normal view in your XML then implement the functionality through code or fully create it by code. Below we will describe both flows:
+
+You will have to create a variable of type Pay-Button-Android, which can be done in one of two ways:
+ - Created in the XML and then linked to a variable in code.
+ - Created totally within the code.
+Once you create the variable in any way, you will have to follow these steps:
+ - Create the parameters.
+ - Pass the parameters to the variable.
+ - Implement PayButtonStatusDelegate interface, which allows you to get notified by different events fired from within the Pay-Button-Android SDK, also called callback functions.
+
+# Initialising the UI
+## Using xml
+  ### 1- create view in xml
+
+```kotlin
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:layout_width="match_parent"
+    android:orientation="vertical"
+    android:layout_height="match_parent"
+    tools:context=".main_activity.MainActivity">
+
+   <company.tap.tappaybuttons.PayButton
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:id="@+id/paybutton"
+
+        />
+
+</LinearLayout>
+ 
+```
+### 2- Accessing the PayButton created in XML in your code 
+### 3. Create an PayButton instance from the created view above to your Activity :
+```kotlin
+    lateinit var payButton: PayButton
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_main)
+payButton = findViewById<PayButton>(R.id.paybutton)
+    }
+
+```
+
+## Using Code to create the PayButton
+
+```kotlin
+    lateinit var payButton: PayButton
+        override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_main)
+
+         val linearLayoutParams = LinearLayout.LayoutParams(
+            LinearLayout.LayoutParams.WRAP_CONTENT, LinearLayout.LayoutParams.WRAP_CONTENT
+        )
+        /** create dynamic view of PayButton view **/ 
+        payButton  = PayButton(this)
+        payButton.layoutParams = linearLayoutParams
+        /** refrence to parent layout view **/  
+        this.findViewById<LinearLayout>(R.id.linear_layout).addView(payButton)
+}
+```
+# Simple Integration
+Here, you'll discover a comprehensive table featuring the parameters applicable to the simple integration. Additionally, you'll explore the various methods for integrating the SDK, either using xml to create the layout and then implementing the interface  functionalities by code, or directly using code. Furthermore, you'll gain insights into how to receive the callback notifications.
+# Parameters
+Each parameter is linked to the reference section, which provides a more in depth explanation of it.
+
+|Parameters|Description | Required | Type| Sample
+|--|--|--| --|--|
+| operator| It has the key obtained after registering your package name, also known as Public key. Also, the [hashString](https://developers.tap.company/docs/webhook#validate-the-webhook-hashstring) value which is used to validate live charges | True  | String| `var operator=HashMap<String,Any>(),operator.put("publicKey","pk_test_YhUjg9PNT8oDlKJ1aE2fMRz7"),operator.put("hashString","")` |
+| order| Order details linked to the charge.| True  | `Dictionary`| ` var order = HashMap<String, Any>(), order.put("id","") order.put("amount",1),order.put("currency","BHD"),order.put("description",""), order.put("reference":"A reference to this order in your system"))` |
+| customer| Customer details for charge process.| True  | `Dictionary`| ` var customer =  HashMap<String,Any> ,customer.put("id,""), customer.put("nameOnCard","Tap Payments"),customer.put("editable",true),) var name :HashMap<String,Any> = [["lang":"en","first":"TAP","middle":"","last":"PAYMENTS"]] "contact":["email":"tap@tap.company", "phone":["countryCode":"+965","number":"88888888"]]] customer.put("name",name) , customer.put("contact",contact)` |
+
+# Configuring the PayButton-Android SDK
+After creating the UI using any of the previously mentioned ways, it is time to pass the parameters needed for the SDK to work as expected and serve your need correctly.
+### 1- Creating the parameters
+To allow flexibility and to ease the integration, your application will only has to pass the parameters as a HashMap<String,Any> .
+First, let us create the required parameters:
+
+```kotlin
+     /**
+       * operator
+       */
+      val operator = HashMap<String,Any>()
+        operator.put("publicKey","pk_test_YhUjg9PNT8oDlKJ1aE2fMRz7")
+        operator.put("hashString","")
+
+        /**
+         * phone
+         */
+        val phone = HashMap<String,Any>()
+        phone.put("countryCode","+20")
+        phone.put("number","011")
+
+        /**
+         * contact
+         */
+        val contact = HashMap<String,Any>()
+        contact.put("email","test@gmail.com")
+        contact.put("phone",phone)
+        /**
+         * name
+         */
+        val name = HashMap<String,Any>()
+        name.put("lang","en")
+        name.put("first","Tap")
+        name.put("middle","")
+        name.put("last","Payment")
+
+        /**
+         * customer
+         */
+        val customer = HashMap<String,Any>()
+        customer.put("nameOnCard","")
+        customer.put("editable",true)
+        customer.put("contact",contact)
+        customer.put("name", listOf(name))
+
+        /**
+         * order
+         */
+        val order = HashMap<String,Any>()
+        order.put("id","order_id")
+        order.put("amount","1")
+        order.put("currency","BHD")
+        order.put("description","description")
+        order.put("reference","refrence_id")
+
+        /**
+         * configuration request
+         */
+
+        val configuration = LinkedHashMap<String,Any>()
+        configuration.put("operator", operator)
+        configuration.put("order",order)
+        configuration.put("customer",customer)
+
+```
+### 2 - Pass these parameters to the created Button variable before as follows
+
+```kotlin
+     payButton.initPayButton(
+            this, 
+            configuration,
+            PayButtonStatusDelegate)
+```
+
+### Full code snippet for creating the parameters + passing it PayButton variable
+```kotlin
+
+override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_main)
+      /**
+       * operator
+       */
+      val operator = HashMap<String,Any>()
+        operator.put("publicKey","pk_test_YhUjg9PNT8oDlKJ1aE2fMRz7")
+        operator.put("hashString","")
+
+        /**
+         * phone
+         */
+        val phone = HashMap<String,Any>()
+        phone.put("countryCode","+20")
+        phone.put("number","011")
+
+        /**
+         * contact
+         */
+        val contact = HashMap<String,Any>()
+        contact.put("email","test@gmail.com")
+        contact.put("phone",phone)
+        /**
+         * name
+         */
+        val name = HashMap<String,Any>()
+        name.put("lang","en")
+        name.put("first","Tap")
+        name.put("middle","")
+        name.put("last","Payment")
+
+        /**
+         * customer
+         */
+        val customer = HashMap<String,Any>()
+        customer.put("nameOnCard","")
+        customer.put("editable",true)
+        customer.put("contact",contact)
+        customer.put("name", listOf(name))
+
+        /**
+         * order
+         */
+        val order = HashMap<String,Any>()
+        order.put("id","order_id")
+        order.put("amount","1")
+        order.put("currency","BHD")
+        order.put("description","description")
+        order.put("reference","refrence_id")
+
+        /**
+         * configuration request
+         */
+
+        val configuration = LinkedHashMap<String,Any>()
+        configuration.put("operator", operator)
+        configuration.put("order",order)
+        configuration.put("customer",customer)
+
+     payButton.initPayButton(
+            this, 
+            configuration,
+            PayButtonStatusDelegate)
+}
+```
+# Receiving Callback Notifications
+Now we have created the UI and the parameters required to to correctly display PayButton form. For the best experience, your class will have to implement PayButtonStatusDelegate interface, which is a set of optional callbacks, that will be fired based on different events from within the payButton button. This will help you in deciding the logic you need to do upon receiving each event. Kindly follow the below steps in order to complete the mentioned flow:
+- Go back to Activity file you want to get the callbacks into.
+- Head to the class declaration line
+- Add PayButtonStatusDelegate
+- Override the required callbacks as follows:
+```kotlin
+ object : PayButtonStatusDelegate {
+                override fun onSuccess(data: String) {
+                    Log.i("data",data.toString())
+                }
+                override fun onReady() {
+                    Log.i("data","onReady")
+
+                }
+
+
+                override fun onError(error: String) {
+                    Log.i("data","onError")
+
+
+                }
+                
+            }
+```
+
+# Advanced Integration
+The advanced configuration for the PayButton-Android integration not only has all the features available in the simple integration but also introduces new capabilities, providing merchants with maximum flexibility. You can find a code below, where you'll discover comprehensive guidance on implementing the advanced flow as well as a complete description of each parameter.
+
+# Parameters
+Each parameter is linked to the reference section, which provides a more in depth explanation of it.
+
+|Parameters |Description | Required | Type| Sample
+|--|--|--| --|--|
+| operator| It has the key obtained after registering your package name, also known as Public key. Also, the [hashString](https://developers.tap.company/docs/webhook#validate-the-webhook-hashstring) value which is used to validate live charges | True  | String| `var operator=HashMap<String,Any>(),operator.put("publicKey","pk_test_YhUjg9PNT8oDlKJ1aE2fMRz7"),operator.put("hashString","")` |
+| order| Order details linked to the charge. | True  | `Dictionary`| ` var order = HashMap<String, Any>(), order.put("id","") order.put("amount",1),order.put("currency","BHD"),order.put("description",""), order.put("reference":"A reference to this order in your system"))` |
+| scope |Intention of the pay button (optional.)  | False  | String| ` var configuration = Hashmap<String,String> , configuration.put("scope","charge") `|
+| transaction |Transaction details linked to the charge.| true  |  Dictionary | ` val transaction = HashMap<String,Any>(), val authorize = HashMap<String,Any>(), authorize.put("type","VOID"),   authorize.put("time", "12" ) , transaction.put("authorize",authroize), transaction.put("reference","Trx")` |
+| invoice|Invoice id to link to the order (optional). | False  | `Dictionary`| ` var invoice = HashMap<String,Any>.put("id","")` |
+| merchant| Merchant id obtained after registering your package name . | True  | `Dictionary`| ` var merchant = HashMap<String,Any>.put("id","")` |
+| customer| Customer details for charge process. | True  | `Dictionary`| ` var customer =  HashMap<String,Any> ,customer.put("id,""), customer.put("nameOnCard","Tap Payments"),customer.put("editable",true),) var name :HashMap<String,Any> = [["lang":"en","first":"TAP","middle":"","last":"PAYMENTS"]] "contact":["email":"tap@tap.company", "phone":["countryCode":"+965","number":"88888888"]]] customer.put("name",name) , customer.put("contact",contact)` |
+| interface| Look and feel related configurations (optional). | False  | `Dictionary`| ` var interface = HashMap<String,Any> ,interface.put("locale","en"), interface.put("theme","light"), interface.put("edges","curved"),interface.put("colorStyle","colored"),interface.put("loader",true) // Allowed values for theme : light/dark. locale: en/ar, edges: curved/flat, direction:ltr/dynaimc,colorStyle:colored/monochrome` |
+| post| Webhook for server-to-server updates (optional). | False  | `Dictionary`| ` var post = HashMap<String,Any>.put("url","")` |
+
+# Initialisation of the input
+You can use a Hashmap to send data to our SDK. The benefit is that you can generate this data from one of your APIs. If we make updates to the configurations, you can update your API, avoiding the need to update your app on the Google play  Store.
+
+
+```kotlin
+     /**
+       * operator
+       */
+      val operator = HashMap<String,Any>()
+        operator.put("publicKey","pk_test_YhUjg9PNT8oDlKJ1aE2fMRz7")
+        operator.put("hashString","")
+
+        /**
+         * phone
+         */
+        val phone = HashMap<String,Any>()
+        phone.put("countryCode","+20")
+        phone.put("number","011")
+
+        /**
+         * contact
+         */
+        val contact = HashMap<String,Any>()
+        contact.put("email","test@gmail.com")
+        contact.put("phone",phone)
+        /**
+         * name
+         */
+        val name = HashMap<String,Any>()
+        name.put("lang","en")
+        name.put("first","Tap")
+        name.put("middle","")
+        name.put("last","Payment")
+
+        /**
+         * customer
+         */
+        val customer = HashMap<String,Any>()
+        customer.put("nameOnCard","")
+        customer.put("editable",true)
+        customer.put("contact",contact)
+        customer.put("name", listOf(name))
+
+        /**
+         * order
+         */
+        val order = HashMap<String,Any>()
+        order.put("id","order_id")
+        order.put("amount","1")
+        order.put("currency","BHD")
+        order.put("description","description")
+        order.put("reference","refrence_id")
+
+        /**
+         * merchant
+         */
+        val merchant = HashMap<String,Any>()
+        merchant.put("id", "")
+
+        /**
+         * invoice
+         */
+        val invoice = HashMap<String,Any>()
+        invoice.put("id","")
+
+     /** interface **/
+
+      val interfacee = HashMap<String,Any>()
+        interfacee.put("locale", "en")
+        interfacee.put("theme","light")
+        interfacee.put("edges", "curved")
+        interfacee.put("colorStyle","colored")
+        interfacee.put("loader",true)
+
+/** transaction **/
+
+
+   val transaction = HashMap<String,Any>()
+
+
+        val authorize = HashMap<String,Any>()
+        authorize.put("type","VOID")
+        authorize.put("time","12")
+
+        transaction.put("reference","TRX")
+        transaction.put("authorize",authorize)
+
+/** redirect **/
+
+        redirect.put("url","onTapKnetRedirect://")
+
+
+
+     /** post  **/
+
+        val post = HashMap<String,Any>()
+        post.put("url","")
+        /**
+         * configuration request
+         */
+
+       
+
+        val configuration = LinkedHashMap<String,Any>()
+        configuration.put("operator", operator)
+        configuration.put("order",order)
+        configuration.put("customer",customer)
+        configuration.put("merchant",merchant)
+        configuration.put("invoice",invoice)
+        configuration.put("interface",interfacee)
+        configuration.put("post",post)
+        configuration.put("scope","charge")
+        configuration.put("transaction",transaction)
+        configuration.put("redirect",redirect)
+
+
+```
+# Receiving Callback Notifications (Advanced Version)
+The below will allow the integrators to get notified from events fired from the PayButton.
+
+```kotlin
+    override fun onReady() {
+           print("\n\n========\n\nonReady")
+    }
+
+    override fun onClick() {
+         print("\n\n========\n\noClick")
+    }
+
+    override fun onChargeCreated(data: String) {
+           print("\n\n========\n\nonChargeCreated")
+    }
+
+    override fun onOrderCreated(data: String) {
+           print("\n\n========\n\nonOrderCreated")
+
+    }
+
+    override fun onCancel() {
+           print("\n\n========\n\nonCancel")
+    }
+
+    override fun onError(error: String) {
+           print("\n\n========\n\nonError")
+    }
+```
+# Full Code Sample
+Once all of the above steps are successfully completed, your Activity file should look like this:
+```kotlin
+
+class MainActivity : AppCompatActivity() ,PayButtonStatusDelegate{
+    lateinit var payButton: PayButton
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_main)
+        configureSdk()
+    }
+
+    fun configureSdk(){
+
+
+        /**
+         * operator
+         */
+        val operator = HashMap<String,Any>()
+        operator.put("publicKey",publicKey.toString())
+        operator.put("hashString",hashStringKey.toString())
+
+        /**
+         * order
+         */
+        val order = HashMap<String,Any>()
+        order.put("id",ordrId ?: "")
+        order.put("amount", "1")
+        order.put("currency",selectedCurrency)
+        order.put("description",orderDescription ?: "")
+        order.put("reference",orderRefrence ?: "")
+
+        /**
+         * merchant
+         */
+        val merchant = HashMap<String,Any>()
+        merchant.put("id", "")
+
+        /**
+         * invoice
+         */
+        val invoice = HashMap<String,Any>()
+        invoice.put("id","")
+
+
+        /**
+         * phone
+         */
+        val phone = java.util.HashMap<String,Any>()
+        phone.put("countryCode","+20")
+        phone.put("number","011")
+
+
+        /**
+         * contact
+         */
+        val contact = java.util.HashMap<String,Any>()
+        contact.put("email","test@gmail.com")
+        contact.put("phone",phone)
+        /**
+         * name
+         */
+        val name = java.util.HashMap<String,Any>()
+        name.put("lang","en")
+        name.put("first", "first")
+        name.put("middle", "middle")
+        name.put("last","last")
+
+        /**
+         * customer
+         */
+        val customer = java.util.HashMap<String,Any>()
+        customer.put("id", "")
+        customer.put("contact",contact)
+        customer.put("name", listOf(name))
+
+        /**
+         * interface
+         */
+    
+        val interfacee = HashMap<String,Any>()
+        interfacee.put("locale",selectedLanguage ?: "en")
+        interfacee.put("theme",selectedTheme ?: "light")
+        interfacee.put("edges",selectedCardEdge ?: "curved")
+        interfacee.put("colorStyle",selectedColorStylee ?:"colored")
+        interfacee.put("loader",loader)
+
+
+        val post = HashMap<String,Any>()
+        post.put("url","")
+        val configuration = LinkedHashMap<String,Any>()
+
+        configuration.put("operator",operator)
+        configuration.put("order",order)
+        configuration.put("customer",customer)
+
+        configuration.put("merchant",merchant)
+        configuration.put("invoice",invoice)
+        configuration.put("interface",interfacee)
+        configuration.put("post",post)
+        configuration.put("scope","charge")
+        configuration.put("transaction",transaction)
+        configuration.put("redirect",redirect)
+
+
+ payButton.initPayButton(
+            this, 
+            configuration,
+            PayButtonStatusDelegate)
+
+
+    }
+
+
+    override fun onSuccess(data: String) {
+    }
+
+    override fun onReady() {
+        super.onReady()
+    }
+
+    override fun onClick() {
+        super.onClick()
+    }
+
+    override fun onChargeCreated(data: String) {
+        super.onChargeCreated(data)
+    }
+
+    override fun onOrderCreated(data: String) {
+        super.onOrderCreated(data)
+    }
+
+    override fun onCancel() {
+        super.onCancel()
+    }
+
+    override fun onError(error: String) {
+    }
+
+}
+```
+
+
+## Parameters Reference
+Below you will find more details about each parameter shared in the above tables that will help you easily integrate PayButton-Android SDK.
+
+### Documentation per variable
+
+ # operator:
+  - Definition: It links the payment gateway to your merchant account with Tap, in order to know your business name, logo, etc...
+  - Type: string (required)
+  - Fields:
+     - publicKey :
+        - Definition: This is a unique public key that you will receive after creating an account with Tap which is considered a reference to identify you as a merchant. You will receive 2 public keys, one for 
+            sandbox/testing and another one for production.
+  - Example: 
+      ```kotlin
+       val operator = HashMap<String,Any>()
+        operator.put("publicKey","publickKeyValue")
+        operator.put("hashString","hashstringValue")
+      ```
+ # scope:
+  - Definition: The scope of the current charge.
+  - Type: string (optional)
+  - values:
+     - charge :
+        - Definition: The scope/intention of the current order to charge the customer. Default
+     - authorize :
+        - Definition: The scope/intention of the current order to authorize an amount from the customer.
+  - Example: 
+      ```kotlin
+        val configuration = LinkedHashMap<String,Any>()
+        configuration.put("scope","charge")
+
+      ```
+
+## order:
+  - Definition:This defined the details of the order that you are trying to purchase, in which you need to specify some details like the id, amount, currency ...
+  - Type: Dictionary, (required)
+  - Fields:
+     - id :
+        - Definition: Pass the order ID created for the order you are trying to purchase, which will be available in your database.
+         Note: This field can be empty
+     - currency :
+        - Definition: The currency which is linked to the order being paid.
+
+     - amount :
+       -  Definition: The order amount to be paid by the customer.
+         Note: Minimum amount to be added is 0.1.   
+     - description :
+        - Definition: Order details, which defines what the customer is paying for or the description of the service you are providing.
+          
+     - reference :
+        - Definition: This will be the order reference present in your database in which the paying is being done for.
+     
+     - Example: 
+      ```kotlin
+      val order = HashMap<String,Any>()
+      order.put("id", "")
+      order.put("amount",  "1" )
+      order.put("currency","BHD")
+      order.put("description", "")
+      order.put("reference", "")
+      ```
+
+ # Transaction:
+  - Definition: This defined the details of the order that you are trying to purchase, in which you need to specify some details like the reference, scope...
+  - Type: Dictionary, (optional)
+  - Fields:
+     - authentication :
+        - Definition: If true, this means that the payment will not be accepted if it is card based and the card is not supporting 3DS.Note: Default is true.
+     - authorize :
+        - Definition: The scope/intention of the current order to authorize an amount from the customer.
+          - Fields:
+               - 1- type :  
+                           - VOID // Will release the held amount
+                           - CAPTURE // Will charge the held amount
+               - 2- time : Definition : An hour based time to perform the post authorize action
+
+
+     - paymentAgreement :
+        - Definition:  If you have created an agreement before, and you want to use it in this transaction pass its id here. Note: It can be empty. Only, related to card based buttons.         
+     - reference :
+        - Definition:  This will be the transaction reference present in your database in which the paying is being done for.          
+ 
+  
+  - Example: 
+      ```kotlin
+         val transaction = HashMap<String,Any>()
+        val authorize = HashMap<String,Any>()
+        authorize.put("type", "VOID")
+        authorize.put("time", "12")
+        transaction.put("reference", "TRX")
+        transaction.put("authorize",authorize )
+
+      ```
+
+
+## merchant:
+  - Definition:It is the Merchant id that you get from our onboarding team. This will be used as reference for your account in Tap.
+  - Type: Dictionary, (required)
+  - Fields:
+     - id :
+        - Definition: Generated once your account with Tap is created, which is unique for every merchant. 
+     - Example: 
+      ```kotlin
+        val merchant = HashMap<String,Any>()
+        merchant.put("id", "")
+      ```
+
+
+## invoice:
+  - Definition:After the token is generated, you can use it to pay for any invoice. Each invoice will have an invoice ID which you can add here using the SDK.
+Note: An invoice will first show you a receipt/summary of the order you are going to pay for as well as the amount, currency, and any related field before actually opening the payment form and completing the payment.
+  - Type: Dictionary, (optional)
+  - Fields:
+     - id :
+        - Definition: Unique Invoice ID which we are trying to pay.
+     
+     - Example: 
+      ```kotlin
+        val invoice = HashMap<String,Any>()
+        invoice.put("id","")
+
+      ```
+
+## post:
+  - Definition:Here you can pass the webhook URL you have, in order to receive notifications of the results of each Transaction happening on your application.
+  - Type: Dictionary, (optional)
+  - Fields:
+     - url :
+        - Definition:The webhook server's URL that you want to receive notifications on.
+     
+     - Example: 
+      ```kotlin
+         val post = HashMap<String,Any>()
+        post.put("url","")
+
+      ```
+
+## customer:
+  - Definition: Here, you will collect the information of the customer that is paying..
+  - Type: Dictionary, (required)
+  - Fields:
+     - id :
+        - Definition: This is an optional field that you do not have before the charge is processed. But, after the charge, then you will receive the customer ID in the response which can be handled in the onSuccess callback function.
+      
+    - name :
+        - Definition: Full Name of the customer paying.
+            - Fields:
+               - lang : Language chosen to write the customer name.
+               - first : Customer's first name.
+               - middle :Customer's middle name.
+               - last : Customer's last name.
+  
+    - contact :
+        - Definition: The customer's contact information like email address and phone number.
+Note: The contact information has to either have the email address or the phone details of the customers or both but it should not be empty.
+
+      - Fields:
+         - email :
+            - Customer's email address (string)
+         - phone :
+            -  Customer's Phone number details with country code and number 
+           
+
+     - Example: 
+      ```kotlin
+         /**
+         * phone
+         */
+        val phone = java.util.HashMap<String,Any>()
+        phone.put("countryCode","+20")
+        phone.put("number","011")
+
+
+        /**
+         * contact
+         */
+        val contact = java.util.HashMap<String,Any>()
+        contact.put("email","test@gmail.com")
+        contact.put("phone",phone)
+        /**
+         * name
+         */
+        val name = java.util.HashMap<String,Any>()
+        name.put("lang","en")
+        name.put("first", "first")
+        name.put("middle", "middle")
+        name.put("last","last")
+
+        /**
+         * customer
+         */
+        val customer = java.util.HashMap<String,Any>()
+        customer.put("id", "")
+        customer.put("contact",contact)
+        customer.put("name", listOf(name))
+
+      ```
+
+
+## interface:
+  - Definition:This will help you control the layout (UI) of the payment form, like changing the theme light to dark, the language used (en or ar), ...
+  - Type: Dictionary, (required)
+  - Fields:
+     - loader :
+        - Definition: A boolean to indicate wether or not you want to show a loading view on top of the pay button while it is performing api requests.
+     - locale :
+        - Definition: The language of the pay button. Accepted values as of now are: (en -> english /ar -> arabic )
+Possible Values:
+
+     - theme :
+       -  Definition: The display styling of the pay button. Accepted values as of now are: light /dark /dynamic
+     - edges :
+        - Definition: Control the edges of the payment form.  (flat/curved)  
+     - colorStyle :
+        - Definition: How do you want the icons rendered inside the pay button Possible Values: colored / monochrome
+     
+     - Example: 
+      ```kotlin
+       val interfacee = HashMap<String,Any>()
+        interfacee.put("locale","en")
+        interfacee.put("theme", "light")
+        interfacee.put("edges", "curved")
+        interfacee.put("colorStyle","colored")
+        interfacee.put("loader",true)
+      ```      
+
+# Expected Callbacks Responses
+
+## onError
+``` kotlin 
+{
+    "error":""
+}
+``` 
+## onOrderCreated
+``` kotlin 
+{
+    "ord_uAx145231127yHYS19Ou9B126"
+
+}
+``` 
+## onChargeCreated
+``` kotlin 
+{
+    {
+    "id": "chg_TS07A5220231433Ql241910314",
+    "object": "charge",
+    "live_mode": false,
+    "customer_initiated": true,
+    "api_version": "V2",
+    "method": "CREATE",
+    "status": "INITIATED",
+    "amount": 0.1,
+    "currency": "BHD",
+    "threeDSecure": true,
+    "card_threeDSecure": false,
+    "save_card": false,
+    "order_id": "ord_uAx145231127yHYS19Ou9B126",
+    "product": "GOSELL",
+    "order": {
+        "id": "ord_uAx145231127yHYS19Ou9B126"
+    },
+    "transaction": {
+        "timezone": "UTC+03:00",
+        "created": "1697726033236",
+        "url": "",
+        "expiry": {
+            "period": 30,
+            "type": "MINUTE"
+        },
+        "asynchronous": false,
+        "amount": 0.1,
+        "currency": "BHD"
+    },
+    "response": {
+        "code": "100",
+        "message": "Initiated"
+    },
+    "receipt": {
+        "email": true,
+        "sms": true
+    },
+    "customer": {
+        "first_name": "TAP",
+        "last_name": "PAYMENTS",
+        "email": "tap@tap.company",
+        "phone": {
+            "country_code": " 965",
+            "number": "88888888"
+        }
+    },
+    "merchant": {
+        "country": "KW",
+        "currency": "KWD",
+        "id": "599424"
+    },
+    "source": {
+        "object": "source",
+        "id": ""
+    },
+    "redirect": {
+        "status": "PENDING",
+        "url": ""
+    },
+    "post": {
+        "status": "PENDING",
+        "url": ""
+    },
+    "activities": [
+        {
+            "id": "activity_TS02A5420231433Mx4g1910470",
+            "object": "activity",
+            "created": 1697726033236,
+            "status": "INITIATED",
+            "currency": "BHD",
+            "amount": 0.1,
+            "remarks": "charge - created"
+        }
+    ],
+    "auto_reversed": false,
+    "gateway_response": {
+        "name": "BENEFITPAY",
+        "request": {
+            "amount": "0.100",
+            "currency": "BHD",
+            "hash": "gMjpC12Ffz+CMhyvm+/jdYJmqbPdgAhHJvvGBABYhCI=",
+            "reference": {
+                "transaction": "chg_TS07A5220231433Ql241910314"
+            },
+            "merchant": {
+                "id": "00000101"
+            },
+            "application": {
+                "id": "4530082749"
+            },
+            "configuration": {
+                "show_result": "0",
+                "hide_mobile_qr": "0",
+                "frequency": {
+                    "start": 120,
+                    "interval": 60,
+                    "count": 10,
+                    "type": "SECOND"
+                }
+            }
+        }
+    }
+}
+
+}
+``` 
+## onSuccess
+``` kotlin 
+{
+   {
+    "id": "chg_TS07A5220231433Ql241910314",
+    "object": "charge",
+    "live_mode": false,
+    "customer_initiated": true,
+    "api_version": "V2",
+    "method": "UPDATE",
+    "status": "INITIATED",
+    "amount": 0.1,
+    "currency": "BHD",
+    "threeDSecure": true,
+    "card_threeDSecure": false,
+    "save_card": false,
+    "order_id": "ord_uAx145231127yHYS19Ou9B126",
+    "product": "GOSELL",
+    "description": "",
+    "order": {
+        "id": "ord_uAx145231127yHYS19Ou9B126"
+    },
+    "transaction": {
+        "timezone": "UTC+03:00",
+        "created": "1697726033236",
+        "url": "https://sandbox.payments.tap.company/test_gosell/v2/payment/tap_process.aspx?chg=8D9e9fdEo5N03hWrGnROvEEFw4DfqYVFv8R7R34GITc%3d",
+        "expiry": {
+            "period": 30,
+            "type": "MINUTE"
+        },
+        "asynchronous": false,
+        "amount": 0.1,
+        "currency": "BHD"
+    },
+    "response": {
+        "code": "100",
+        "message": "Initiated"
+    },
+    "receipt": {
+        "email": true,
+        "sms": true
+    },
+    "customer": {
+        "first_name": "TAP",
+        "last_name": "PAYMENTS",
+        "email": "tap@tap.company",
+        "phone": {
+            "country_code": " 965",
+            "number": "88888888"
+        }
+    },
+    "merchant": {
+        "country": "KW",
+        "currency": "KWD",
+        "id": "599424"
+    },
+    "source": {
+        "object": "source",
+        "id": "src_benefit_pay"
+    },
+    "redirect": {
+        "status": "PENDING",
+        "url": ""
+    },
+    "post": {
+        "status": "PENDING",
+        "url": ""
+    },
+    "activities": [
+        {
+            "id": "activity_TS02A5420231433Mx4g1910470",
+            "object": "activity",
+            "created": 1697726033236,
+            "status": "INITIATED",
+            "currency": "BHD",
+            "amount": 0.1,
+            "remarks": "charge - created"
+        }
+    ],
+    "auto_reversed": false,
+    "gateway_response": {
+        "name": "",
+        "request": {
+            "amount": "0.100",
+            "currency": "BHD",
+            "hash": "gMjpC12Ffz+CMhyvm+/jdYJmqbPdgAhHJvvGBABYhCI=",
+            "reference": {
+                "transaction": "chg_TS07A5220231433Ql241910314"
+            },
+            "merchant": {
+                "id": "00000101"
+            },
+            "application": {
+                "id": "4530082749"
+            },
+            "configuration": {
+                "show_result": "0",
+                "hide_mobile_qr": "0",
+                "frequency": {
+                    "start": 120,
+                    "interval": 60,
+                    "count": 10,
+                    "type": "SECOND"
+                }
+            }
+        }
+    }
+}
+
+}
+``` 
+
+# Available Button Types
+ 1.BenefitPay<br>
+ 2.KNEt<br>
+ 3.Benefit
+
+
+# Generate the hash string[](https://developers.tap.company/docs/benefit-pay-android#generate-the-hash-string)
+
+1. Import the Crypto
+```kotlin
+import javax.crypto.Mac
+import javax.crypto.spec.SecretKeySpec
+import java.util.Formatter
+``` 
+2. Copy this helper singleton class
+```kotlin
+
+/// Create a singleton class where you can use as a helper to generate hash strings
+object TapHmac {
+	/**
+     This is a helper method showing how can you generate a hash string when performing live charges
+     - Parameter publicKey:             The Tap public key for you as a merchant pk_.....
+     - Parameter secretKey:             The Tap secret key for you as a merchant sk_.....
+     - Parameter amount:                The amount you are passing to the SDK, ot the amount you used in the order if you created the order before.
+     - Parameter currency:              The currency code you are passing to the SDK, ot the currency code you used in the order if you created the order before. PS: It is the capital case of the 3 iso country code ex: SAR, KWD.
+     - Parameter post:                  The post url you are passing to the SDK, ot the post url you pass within the Charge API. If you are not using postUrl please pass it as empty string
+     - Parameter transactionReference:  The reference.trasnsaction you are passing to the SDK(not all SDKs supports this,) or the reference.trasnsaction  you pass within the Charge API. If you are not using reference.trasnsaction please pass it as empty string
+     */
+    fun generateTapHashString(publicKey:String, secretKey:String, amount:Double, currency:String, postUrl:String = "", transactionReference:String = ""): String {
+        // Let us generate our encryption key
+        val signingKey = SecretKeySpec(secretKey.toByteArray(), "HmacSHA256")
+        val mac = Mac.getInstance("HmacSHA256")
+        mac.init(signingKey)
+        // For amounts, you will need to make sure they are formatted in a way to have the correct number of decimal points. For BHD we need them to have 3 decimal points
+		val formattedAmount:String = String.format("%.3f", amount)
+        // Let us format the string that we will hash
+        val toBeHashed = "x_publickey${publicKey}x_amount${formattedAmount}x_currency${currency}x_transaction${transactionReference}x_post$postUrl"
+        // let us generate the hash string now using the HMAC SHA256 algorithm
+        val bytes = mac.doFinal(toBeHashed.toByteArray())
+        return format(bytes)
+    }
+
+    private fun format(bytes: ByteArray): String {
+        val formatter = Formatter()
+        bytes.forEach { formatter.format("%02x", it) }
+        return formatter.toString()
+    }
+}
+```
+3. Call it as follows:
+```kotlin
+val hashString:String = TapHmac.generateTapHashString(publicKey, secretKey, amount, currency, postUrl)
+```
+4. Pass it within the operator model
+```kotlin
+val operator = HashMap<String,Any>()
+operator.put("publicKey","publickKeyValue")
+operator.put("hashString",hashString)
+```
+
diff --git a/app/src/main/java/company/tap/paybutton/MainActivity.kt b/app/src/main/java/company/tap/paybutton/MainActivity.kt
index d890dab..fe682a1 100644
--- a/app/src/main/java/company/tap/paybutton/MainActivity.kt
+++ b/app/src/main/java/company/tap/paybutton/MainActivity.kt
@@ -6,9 +6,9 @@ import android.os.Bundle
 import android.util.Log
 import android.widget.Toast
 import com.chillibits.simplesettings.tool.getPrefStringValue
-import com.example.tappaybutton.PayButtonType
-import company.tap.tappaybuttons.PayButton
-import company.tap.tappaybuttons.PayButtonStatusDelegate
+import company.tap.tappaybutton.PayButtonType
+import company.tap.tappaybutton.PayButton
+import company.tap.tappaybutton.PayButtonStatusDelegate
 
 class MainActivity : AppCompatActivity() {
     lateinit var payButton: PayButton
@@ -167,7 +167,7 @@ class MainActivity : AppCompatActivity() {
 
 
         findViewById<PayButton>(R.id.paybutton).initPayButton(this, configuration,
-            PayButtonType.valueOf(buttonKey.toString()),object :PayButtonStatusDelegate{
+            PayButtonType.valueOf(buttonKey.toString()),object : PayButtonStatusDelegate {
             override fun onSuccess(data: String) {
                 Toast.makeText(this@MainActivity,"success $data",Toast.LENGTH_SHORT).show()
             }
diff --git a/app/src/main/res/layout/activity_main.xml b/app/src/main/res/layout/activity_main.xml
index 0df49c8..6aa817f 100644
--- a/app/src/main/res/layout/activity_main.xml
+++ b/app/src/main/res/layout/activity_main.xml
@@ -7,7 +7,7 @@
     android:orientation="vertical"
     tools:context=".MainActivity">
 
-    <company.tap.tappaybuttons.PayButton
+    <company.tap.tappaybutton.PayButton
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:layout_marginTop="@dimen/_10sdp"
diff --git a/local.properties b/local.properties
index 801d904..415631a 100644
--- a/local.properties
+++ b/local.properties
@@ -4,5 +4,5 @@
 # Location of the SDK. This is only used by Gradle.
 # For customization when using a Version Control System, please read the
 # header note.
-#Thu Oct 26 08:38:27 BRT 2023
-sdk.dir=/Users/macbookpro/Library/Android/sdk
+#Thu Oct 26 15:27:36 AST 2023
+sdk.dir=/Users/akazi/Library/Android/sdk
diff --git a/tappaybutton/src/androidTest/java/com/example/tappaybutton/ExampleInstrumentedTest.kt b/tappaybutton/src/androidTest/java/com/example/tappaybutton/ExampleInstrumentedTest.kt
index 6161b1a..704c100 100644
--- a/tappaybutton/src/androidTest/java/com/example/tappaybutton/ExampleInstrumentedTest.kt
+++ b/tappaybutton/src/androidTest/java/com/example/tappaybutton/ExampleInstrumentedTest.kt
@@ -6,7 +6,7 @@
  *
  */
 
-package com.example.tappaybutton
+package company.tap.tappaybutton
 
 import androidx.test.platform.app.InstrumentationRegistry
 import androidx.test.ext.junit.runners.AndroidJUnit4
@@ -27,6 +27,6 @@ class ExampleInstrumentedTest {
     fun useAppContext() {
         // Context of the app under test.
         val appContext = InstrumentationRegistry.getInstrumentation().targetContext
-        assertEquals("com.example.tappaybutton.test", appContext.packageName)
+        assertEquals("company.tap.tappaybutton.test", appContext.packageName)
     }
 }
\ No newline at end of file
diff --git a/tappaybutton/src/main/java/com/example/tappaybutton/PayButton.kt b/tappaybutton/src/main/java/company/tap/tappaybutton/PayButton.kt
similarity index 97%
rename from tappaybutton/src/main/java/com/example/tappaybutton/PayButton.kt
rename to tappaybutton/src/main/java/company/tap/tappaybutton/PayButton.kt
index 3a1a0a7..365abba 100644
--- a/tappaybutton/src/main/java/com/example/tappaybutton/PayButton.kt
+++ b/tappaybutton/src/main/java/company/tap/tappaybutton/PayButton.kt
@@ -7,14 +7,12 @@
  **
  */
 
-package company.tap.tappaybuttons
+package company.tap.tappaybutton
 import android.content.Context
 import android.util.AttributeSet
 import android.view.View
 import android.widget.LinearLayout
 import android.widget.Toast
-import com.example.tappaybutton.PayButtonType
-import com.example.tappaybutton.R
 import company.tap.tapWebForm.open.KnetPayStatusDelegate
 import company.tap.tapWebForm.open.web_wrapper.TapKnetConfiguration
 import company.tap.tapWebForm.open.web_wrapper.TapKnetPay
diff --git a/tappaybutton/src/main/java/com/example/tappaybutton/PayButtonStatusDelegate.kt b/tappaybutton/src/main/java/company/tap/tappaybutton/PayButtonStatusDelegate.kt
similarity index 91%
rename from tappaybutton/src/main/java/com/example/tappaybutton/PayButtonStatusDelegate.kt
rename to tappaybutton/src/main/java/company/tap/tappaybutton/PayButtonStatusDelegate.kt
index 00f0a33..a1fd4c8 100644
--- a/tappaybutton/src/main/java/com/example/tappaybutton/PayButtonStatusDelegate.kt
+++ b/tappaybutton/src/main/java/company/tap/tappaybutton/PayButtonStatusDelegate.kt
@@ -1,4 +1,4 @@
-package company.tap.tappaybuttons
+package company.tap.tappaybutton
 /*
  * *
  *  * Created by AhlaamK on 10/26/23, 8:19 AM
diff --git a/tappaybutton/src/main/java/com/example/tappaybutton/PayButtonType.kt b/tappaybutton/src/main/java/company/tap/tappaybutton/PayButtonType.kt
similarity index 91%
rename from tappaybutton/src/main/java/com/example/tappaybutton/PayButtonType.kt
rename to tappaybutton/src/main/java/company/tap/tappaybutton/PayButtonType.kt
index 44604dc..c2d8cd1 100644
--- a/tappaybutton/src/main/java/com/example/tappaybutton/PayButtonType.kt
+++ b/tappaybutton/src/main/java/company/tap/tappaybutton/PayButtonType.kt
@@ -13,7 +13,7 @@
  **
  */
 
-package com.example.tappaybutton
+package company.tap.tappaybutton
 
 enum class PayButtonType {
     BENEFIT_PAY,
diff --git a/tappaybutton/src/test/java/com/example/tappaybutton/ExampleUnitTest.kt b/tappaybutton/src/test/java/com/example/tappaybutton/ExampleUnitTest.kt
index 7ac5c4d..51e0532 100644
--- a/tappaybutton/src/test/java/com/example/tappaybutton/ExampleUnitTest.kt
+++ b/tappaybutton/src/test/java/com/example/tappaybutton/ExampleUnitTest.kt
@@ -6,7 +6,7 @@
  *
  */
 
-package com.example.tappaybutton
+package company.tap.tappaybutton
 
 import org.junit.Test