Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 12 additions & 12 deletions android/androideventlisteners.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,9 +20,9 @@ You must provide a class implementing this interface when initializing the SDK f
public final class EventHandler implements Events.SmartposRequired {

@Override
public void connectionStatusChanged(ConnectionStatus status, Device device) { ... }
public void connectionStatusChanged(ConnectionStatus status, Device device) { ... }
@Override
public void currentTransactionStatus(StatusInfo statusInfo, Device device) { ... }
public void currentTransactionStatus(StatusInfo statusInfo, Device device) { ... }
@Override
public void endOfTransaction(TransactionResult transactionResult, Device device) { ... }
@Override
Expand All @@ -49,14 +49,14 @@ You must provide a class implementing this interface when initializing the SDK f

```java
public final class EventHandler implements Events.MposRequired {
@Override
public void deviceDiscoveryFinished(List devices) { ... }
@Override
public void connectionStatusChanged(ConnectionStatus status, Device device) { ... }
public void deviceDiscoveryFinished(List devices) { ... }
@Override
public void connectionStatusChanged(ConnectionStatus status, Device device) { ... }
@Override
public void currentTransactionStatus(StatusInfo statusInfo, Device device) { ... }
public void currentTransactionStatus(StatusInfo statusInfo, Device device) { ... }
@Override
public void signatureRequired(SignatureRequest signatureRequest, Device device) { ... }
public void signatureRequired(SignatureRequest signatureRequest, Device device) { ... }
@Override
public void endOfTransaction(TransactionResult transactionResult, Device device) { ... }
@Override
Expand All @@ -82,14 +82,14 @@ You must provide a class implementing this interface when initializing the SDK w

```java
public final class EventHandler implements Events.PosRequired {
@Override
public void deviceDiscoveryFinished(List devices) { ... }
@Override
public void connectionStatusChanged(ConnectionStatus status, Device device) { ... }
public void deviceDiscoveryFinished(List devices) { ... }
@Override
public void connectionStatusChanged(ConnectionStatus status, Device device) { ... }
@Override
public void currentTransactionStatus(StatusInfo statusInfo, Device device) { ... }
public void currentTransactionStatus(StatusInfo statusInfo, Device device) { ... }
@Override
public void signatureRequired(SignatureRequest signatureRequest, Device device) { ... }
public void signatureRequired(SignatureRequest signatureRequest, Device device) { ... }
@Override
public void endOfTransaction(TransactionResult transactionResult, Device device) { ... }
@Override
Expand Down
41 changes: 7 additions & 34 deletions android/androidintroduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,11 @@ id: androidintroduction
<h3>Android SDK</h3>
</div>
<div class="card__body">
<a href="https://search.maven.org/artifact/com.handpoint.api/sdk/">
<img src="https://handpoint.imgix.net/ballicons/small/android.png"/>
</a>
</div>
<div class="card__footer">
:::info
Get our latest android SDK! Ask our support team to obtain access if you don't have already<br />
:::
Get our latest android SDK! Ask our support team to obtain access if you don't have already.<br />
In our <strong>Nexus Repository</strong> you will find both Development and Production <strong>SDK</strong> versions.
</div>
</div>
</div>
Expand All @@ -47,11 +44,11 @@ We take care of PCI compliance so you can be kept out of PCI scope. The Handpoin

### SDK distribution

The Handpoint Android SDK is available on Maven central as well as the Handpoint internal Nexus server. Maven central contains the **production builds** while Nexus contains **development snapshots** of the SDK.
- If you are integrating your software with a **PAX debug terminal** you will need to get the SDK from **Nexus**.
- If you are integrating your software with a **PAX production terminal** you will need to get the SDK from **Maven Central**.
- If you are integrating your software with an HiLite terminal you will need to get the SDK from **Maven Central**.
The Handpoint Android SDK is available on the Handpoint internal Nexus server which contains both the **production builds** and **development snapshots** of the SDK.
- If you are integrating your software with a **PAX debug terminal** you will need to use the development Snapshots, listed as -RC.X-SNAPSHOT for example **7.1010.3-RC.1-SNAPSHOT**
- If you are integrating your software with a **PAX production terminal** or with a **HiLite terminal** you will need to use the Production versions listed eg **7.1010.3**

If in doubt regarding what version to use, we always recommend using the latest available production version, for development snapshots the recommendation is to use the latest RC (highest number) that matches the latest production SDK version published. Our support team is also available to answer any questions regarding what version to use.

The Handpoint Android SDK is compatible with Android version 5.1.1 [(API level 22)](https://developer.android.com/about/versions/lollipop/android-5.1) and up.
The latest version is compiled with java **1.8**
Expand Down Expand Up @@ -85,32 +82,14 @@ We **strongly** recommend you add the following to your `AndroidManifest.xml`:

### Gradle Settings

#### For production terminals (Maven):
```groovy
//Handpoint Production SDK (Production terminals)
implementation 'com.handpoint.api:sdk:7.x.x'
```
In the `gradle.build` (Top-level build file) for production terminals (Maven):

```groovy
allprojects { //Handpoint Production SDK (Production terminals)
repositories {
google()
mavenCentral()
maven { url 'https://jitpack.io' }
}
}
```

#### For debug terminals (Nexus) [Only applies to PAX/Telpo devices]:
```groovy
//Handpoint Staging/Development SDK (Debug terminals)
implementation 'com.handpoint.api:sdk:7.x.x-RC.x-SNAPSHOT'
```
In the `gradle.build` (Top-level build file) for debug terminals (Nexus) [Only applies to PAX/Telpo devices]:

```groovy
allprojects { //Handpoint Staging/Development SDK (Debug terminals)
allprojects {
repositories {
google()
mavenCentral()
Expand Down Expand Up @@ -154,12 +133,6 @@ android {
}
```

:::tip
If using AndroidX you will need to switch the following flags to true:<br></br>
android.enableJetifier=true<br></br>
android.useAndroidX=true
:::

It is time to visit our **[Integration Guides](androidintegrationguide)** section.

If you have any questions, do not hesitate to **[Contact Us](mailto:support@handpoint.com)**.
28 changes: 14 additions & 14 deletions android/androidmigrationguide.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,8 +75,8 @@ public class HandpointDelegate implements
```java
class KotlinClient:
Events.Required,
Events.CurrentTransactionStatus,
Events.ConnectionStatusChanged {
Events.CurrentTransactionStatus,
Events.ConnectionStatusChanged {
```

</TabItem>
Expand All @@ -88,11 +88,11 @@ class KotlinClient:

```java
public class HandpointDelegate implements
Events.SmartposRequired,
Events.CurrentTransactionStatus,
Events.ConnectionStatusChanged,
Events.EndOfTransaction,
Events.TransactionResultReady {
Events.SmartposRequired,
Events.CurrentTransactionStatus,
Events.ConnectionStatusChanged,
Events.EndOfTransaction,
Events.TransactionResultReady {
```

</TabItem>
Expand Down Expand Up @@ -129,7 +129,7 @@ public class HandpointDelegate implements

```java
class KotlinClient:
Events.Required,
Events.Required,
Events.ConnectionStatusChanged,
Events.CurrentTransactionStatus {
```
Expand All @@ -145,11 +145,11 @@ class KotlinClient:
public class JavaClient implements
Events.MposRequired,
Events.ConnectionStatusChanged,
Events.CurrentTransactionStatus,
Events.SignatureRequired,
Events.EndOfTransaction,
Events.DeviceDiscoveryFinished,
Events.TransactionResultReady {
Events.CurrentTransactionStatus,
Events.SignatureRequired,
Events.EndOfTransaction,
Events.DeviceDiscoveryFinished,
Events.TransactionResultReady {
```

</TabItem>
Expand Down Expand Up @@ -186,7 +186,7 @@ public class HandpointDelegate implements

```java
class KotlinClient:
Events.Required,
Events.Required,
Events.ConnectionStatusChanged,
Events.CurrentTransactionStatus {
```
Expand Down
30 changes: 15 additions & 15 deletions android/androidobjects.md
Original file line number Diff line number Diff line change
Expand Up @@ -166,14 +166,14 @@ An enum representing all the supported acquirers for merchant authentication.

```java
public enum Acquirer { AMEX,
BORGUN,
EVO,
OMNIPAY,
POSTBRIDGE,
INTERAC,
TSYS,
VANTIV,
SANDBOX
BORGUN,
EVO,
OMNIPAY,
POSTBRIDGE,
INTERAC,
TSYS,
VANTIV,
SANDBOX
}
```

Expand Down Expand Up @@ -431,9 +431,9 @@ A class containing the credentials used to communicate with the payment terminal

```java
{
String sharedSecret = "0102030405060708091011121314151617181920212223242526272829303132";
HandpointCredentials handpointCredentials = new HandpointCredentials(sharedSecret);
//We've even set a default shared secret!
String sharedSecret = "0102030405060708091011121314151617181920212223242526272829303132";
HandpointCredentials handpointCredentials = new HandpointCredentials(sharedSecret);
//We've even set a default shared secret!
}
```

Expand Down Expand Up @@ -461,9 +461,9 @@ getAsyncInterface( Events.Required requiredListener , Context context , Handpoin
//InitApi for Datecs devices or PAX/Telpo ConnectionMethod.ANDROID_PAYMENT
public void InitApi()
{
String sharedSecret = "0102030405060708091011121314151617181920212223242526272829303132";
api = HapiFactory.getAsyncInterface(this, new HandpointCredentials(sharedSecret));
//The api is now initialized. Yay! we've even set a default shared secret
String sharedSecret = "0102030405060708091011121314151617181920212223242526272829303132";
api = HapiFactory.getAsyncInterface(this, new HandpointCredentials(sharedSecret));
//The api is now initialized. Yay! we've even set a default shared secret
}
```

Expand Down Expand Up @@ -736,7 +736,7 @@ MoToOptions moToOptions = new MoToOptions(moneyRemittanceOptions);

`OperationDto` <span class="badge badge--info">Object</span>

Object indicating which financial transaction type needs to be performed after tokenization of the card during a Tokenize and Modify operation.
Object indicating which financial transaction type needs to be performed after tokenization of the card during a Tokenize Payment Operation.

**Properties**

Expand Down
Loading