SDK > Android | Payment Gateway

Android

Android is an open-source operating system based on the Linux kernel and primarily designed for mobile devices such as smartphones, tablets, and smartwatches. It is developed by Google and offers a wide range of features and applications to enhance user experience.

You can download the XPay SDK for Android provided by Nexi from the following GitHub repository:

Android SDK XPay

ATTENTION: Merchants are responsible for the proper and secure storage of their API keys. These should not be stored within the client app but must be securely requested and exchanged between the app and the merchant's server.

Installation

To use the XPay SDK, you need to add it as a dependency to your application and create the XPay client:

Hosted Payment Page

The following method refers to the API POST /orders/hpp.

A WebView is opened containing the XPay checkout page.

In order to use this functionality you must declare a request code to intercept the ActivityResult inside your desired Activity:

                                    Activity activity = this;
CreateHostedOrderWebViewRequest request; // initialize the request
paymentClient.loadHostedPaymentPage(activity, request, HPP_WEBVIEW_REQUEST_CODE);
                                

Handle the ActivityResult inside your Activity:

                                    @Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (data == null) { // User has canceled the operation
return;
}
switch (requestCode) {
case HPP_WEBVIEW_REQUEST_CODE:
showHostedPaymentPageResult(resultCode, data);
break;
}
}
private void showHostedPaymentPageResult(int resultCode, Intent data) {
// You can have your initial request back
CreateHostedOrderWebViewRequest request = (CreateHostedOrderWebViewRequest)data.getSerializableExtra("request");
if (resultCode == RESULT_OK) {
Operation response = (Operation)data.getSerializableExtra("response");
// handle the response
} else {
Exception exception = (Exception)data.getSerializableExtra("exception");
// handle the error cases
}
}
                                

To independently choose the WebView for displaying the checkout page, you need to use the following method: it returns the link to the XPay checkout page to be displayed in the WebView.

In order to use this functionality you must declare a request code to intercept the ActivityResult inside your desired Activity:

                                    Activity activity = this;
CreateHostedOrderWebViewRequest request; // initialize the request
paymentClient.createHostedPaymentPage(activity, request, HPP_NO_WEBVIEW_REQUEST_CODE);
                                

Handle the ActivityResult inside your Activity:

                                    @Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (data == null) { // User has canceled the operation
return;
}
switch (requestCode) {
case HPP_NO_WEBVIEW_REQUEST_CODE:
showHostedPaymentPageResult(resultCode, data);
break;
}
}
private void showHostedPaymentPageResult(int resultCode, Intent data) {
// You can have your initial request back
CreateHostedOrderWebViewRequest request = (CreateHostedOrderWebViewRequest)data.getSerializableExtra("request");
if (resultCode == RESULT_OK) {
CreateHostedOrderResponse response = (CreateHostedOrderResponse)data.getSerializableExtra("response");
// handle the response
} else {
Exception exception = (Exception)data.getSerializableExtra("exception");
// handle the error cases
}
}
                                

Get Payments Methods

The following method refers to the API POST /payment_methods.

The list of payment methods supported by the merchant's terminal is returned along with their associated attributes.

In order to use this functionality you must declare a request code to intercept the ActivityResult inside your desired Activity:

                                    Activity activity = this;
paymentClient.getPaymentMethods(activity, PAYMENT_METHODS_REQUEST_CODE);
                                

Handle the ActivityResult inside your Activity:

                                    @Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (data == null) { // User has canceled the operation
return;
}
switch (requestCode) {
case PAYMENT_METHODS_REQUEST_CODE:
showPaymentMethodsResult(resultCode, data);
break;
}
}
private void showPaymentMethodsResult(int resultCode, Intent data) {
if (resultCode == RESULT_OK) {
PaymentMethodsResponse response = (PaymentMethodsResponse)data.getSerializableExtra("response");
// handle the response
} else {
Exception exception = (Exception)data.getSerializableExtra("exception");
// handle the error cases
}
}
                                

                                    <it.nexi.ngp.sdk.features.cardpayment.cardform.view.CardFormInline
android:id="@+id/card_form"
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
<Button
android:id="@+id/continue_btn"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_marginTop="16dp"
android:backgroundTint="#2D32A9"
android:text="Continue"
android:textColor="#fff"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@id/card_form" />
                                

                                    private CardFormInline cardForm;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.id.your_layout);
cardForm = findViewById(R.id.card_form);
cardForm.setup(this);
ThreeDSOrderRequest orderRequest = (ThreeDSOrderRequest)getIntent().getSerializableExtra("request");
Button continueBtn = findViewById(R.id.continue_btn);
continueBtn.setOnClickListener(view -> {
paymentClient.loadTwoStepPaymentPage(this, cardForm, orderRequest, TWO_STEP_REQUEST_CODE);
});
}
                                

Handle the ActivityResult inside your Activity:

                                    @Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (data == null) { // User has canceled the operation
return;
}
switch (requestCode) {
case TWO_STEP_REQUEST_CODE:
showTwoStepPaymentResult(resultCode, data);
break;
}
}
private void showTwoStepPaymentResult(int resultCode, Intent data) {
if (resultCode == RESULT_OK) {
ThreeDSPaymentResponse response = (ThreeDSPaymentResponse)data.getSerializableExtra("response");
// handle the response
} else {
Exception exception = (Exception)data.getSerializableExtra("exception");
// handle the error cases
}
}
                                

3 Step payment

The following method refers to the Payment 3 Steps solution.

It allows making payments through card with 3D Secure authentication, in Server-to-Server mode.

Server-to-Server solutions are subject to obtaining PCI DSS security certification (SAQ D questionnaire).

In order to use this functionality you have to instantiate a derived instance of CardForm either it be CardFormFull or CardFormInline in order to send the customer card data that must be declared inside your layout xml:

                                    <it.nexi.ngp.sdk.features.cardpayment.cardform.view.CardFormInline
android:id="@+id/card_form"
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
<Button
android:id="@+id/continue_btn"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_marginTop="16dp"
android:backgroundTint="#2D32A9"
android:text="Continue"
android:textColor="#fff"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@id/card_form" />
                                

                                    private CardFormFull cardForm;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.id.your_layout);
cardForm = findViewById(R.id.card_form);
cardForm.setup(this);
ThreeDSOrderRequest orderRequest = (ThreeDSOrderRequest)getIntent().getSerializableExtra("request");
Button continueBtn = findViewById(R.id.continue_btn);
continueBtn.setOnClickListener(view -> {
paymentClient.loadThreeStepPaymentPage(this, cardForm, orderRequest, THREE_STEP_REQUEST_CODE);
});
}
                                

Handle the ActivityResult inside your Activity:

                                    @Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (data == null) { // User has canceled the operation
return;
}
switch (requestCode) {
case THREE_STEP_REQUEST_CODE:
showThreeStepPaymentResult(resultCode, data);
break;
}
}
private void showThreeStepPaymentResult(int resultCode, Intent data) {
if (resultCode == RESULT_OK) {
ThreeDSPaymentResponse response = (ThreeDSPaymentResponse)data.getSerializableExtra("response");
// handle the response
} else {
Exception exception = (Exception)data.getSerializableExtra("exception");
// handle the error cases
}
}
                                

Card Verification

The following method refers to the Card Verification solution.

It performs a card verification operation, without any charge, solely to confirm the validity of the card data entered by the customer.

Server-to-Server solutions are subject to obtaining PCI DSS security certification (SAQ D questionnaire).

In order to use this functionality you must declare a request code to intercept the ActivityResult inside your desired Activity:

                                    Activity activity = this;
CardVerificationRequest request; // initialize the request
paymentClient.verifyCard(activity, request, CARD_VERIFICATION_REQUEST_CODE);
                                

Handle the ActivityResult inside your Activity:

                                    @Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (data == null) { // User has canceled the operation
return;
}
switch (requestCode) {
case CARD_VERIFICATION_REQUEST_CODE:
showCardVerificationResult(resultCode, data);
break;
}
}
private void showCardVerificationResult(int resultCode, Intent data) {
// You can have your initial request back
CardVerificationRequest request = (CardVerificationRequest)data.getSerializableExtra("request");
if (resultCode == RESULT_OK) {
CardVerificationResponse response = (CardVerificationResponse)data.getSerializableExtra("response");
// handle the response
} else {
Exception exception = (Exception)data.getSerializableExtra("exception");
// handle the error cases
}
}
                                

M.O.T.O.

The following method refers to the API POST /orders/moto.

It performs a M.O.T.O payment: a payment made in Server-to-Server mode, where the cardholder's 3D Secure authentication is not required. It is intended for those who want to integrate the authorization request function for credit card payments, where the cardholder's data has been communicated to the merchant via email, phone, etc.

Server-to-Server solutions are subject to obtaining PCI DSS security certification (SAQ D questionnaire).

In order to use this functionality you must declare a request code to intercept the ActivityResult inside your desired Activity:

                                    Activity activity = this;
MotoRequest request; // initialize the request
paymentClient.processMoto(activity, request, MOTO_REQUEST_CODE);
                                

Handle the ActivityResult inside your Activity:

                                    @Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (data == null) { // User has canceled the operation
return;
}
switch (requestCode) {
case MOTO_REQUEST_CODE:
showMotoResult(resultCode, data);
break;
}
}
private void showMotoResult(int resultCode, Intent data) {
// You can have your initial request back
MotoRequest request = (MotoRequest)data.getSerializableExtra("request");
if (resultCode == RESULT_OK) {
MotoResponse response = (MotoResponse)data.getSerializableExtra("response");
// handle the response
} else {
Exception exception = (Exception)data.getSerializableExtra("exception");
// handle the error cases
}
}
                                