SDK > Android | Payment Gateway

Android

Android è un sistema operativo open source basato sul kernel Linux e progettato principalmente per dispositivi mobili come smartphone, tablet e smartwatch. È sviluppato da Google e offre un'ampia gamma di funzionalità e applicazioni per migliorare l'esperienza degli utenti.

Dalla seguente repository GitHub è possibile scaricare l'SDK XPay per Android messo a disposizione da Nexi:

Android SDK XPay

ATTENZIONE: gli esercenti sono responsabili della corretta e sicura gestione delle proprie api-key. Le stesse non dovrebbero essere memorizzate nell'app client, ma devono essere richieste e scambiate in modo sicuro tra l'app e il server dell'esercente.

Installazione

Per utilizzare l'SDK XPay è necessario aggiungerlo come dipendenza all'applicazione e creare il client XPay:

Hosted Payment Page

Il seguente metodo fa riferimento all'API POST /orders/hpp.

Viene aperta una WebView contenente la pagina di cassa XPay.

Per utilizzare questa funzionalità, è necessario dichiarare un codice di richiesta per intercettare il risultato dell'attività all'interno dell'Activity desiderata:

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

Gestire il risultato dell'attività all'interno della tua 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
}
}
                                

Per scegliere in modo autonomo la WebView con cui mostrare la pagina di cassa è necessario utilizzare il seguente metodo: restituisce il link alla pagina di cassa XPay da mostrare in WebView.

Per utilizzare questa funzionalità, è necessario dichiarare un codice di richiesta per intercettare il risultato dell'attività all'interno dell'Activity desiderata:

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

Gestire il risultato dell'attività all'interno della tua 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
}
}
                                

Metodi di Pagamento

Il seguente metodo fa riferimento all'API POST /payment_methods.

Viene restituito l'elenco dei metodi di pagamento supportati dal terminale dell'esercente insieme agli attributi associati.

Per utilizzare questa funzionalità, è necessario dichiarare un codice di richiesta per intercettare il risultato dell'attività all'interno dell'Activity desiderata:

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

Gestire il risultato dell'attività all'interno della tua 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);
});
}
                                

Gestire il risultato dell'attività all'interno della tua 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
}
}
                                

Pagamento 3 Step

Il seguente metodo fa riferimento all'a soluzione Pagamento 3 Steps.

Permette di effettuare pagamenti tramite carta con autenticazione 3D Secure, in modalità Server to Server.

Le soluzioni Server to Server sono subordinate all'ottenimento della certificazione di sicurezza PCI DSS (questionario SAQ D).

Per utilizzare questa funzionalità, devi istanziare un'istanza derivata di CardForm, che sia CardFormFull o CardFormInline, al fine di inviare i dati della carta del cliente che devono essere dichiarati all'interno del tuo 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);
});
}
                                

Gestire il risultato dell'attività all'interno della tua 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
}
}
                                

Verifica carta

Il seguente metodo fa riferimento alla soluzione Verifica carta.

Effettua un'operazione di verifica carta, senza nessun addebito, con il solo scopo di confermare la validità dei dati carta inseriti dal cliente.

Le soluzioni Server to Server sono subordinate all'ottenimento della certificazione di sicurezza PCI DSS (questionario SAQ D).

Per utilizzare questa funzionalità, è necessario dichiarare un codice di richiesta per intercettare il risultato dell'attività all'interno dell'Activity desiderata:

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

Gestire il risultato dell'attività all'interno della tua 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.

Il seguente metodo fa riferimento all'API POST /orders/moto.

Effetua un pagamento M.O.T.O: pagamento effettuato in modalità Server to Server, nei quali non viene richiesta l’autenticazione 3D Secure del titolare. E’ destinata a chi desidera integrare sul proprio sistema la funzione di richiesta autorizzazione di pagamenti tramite carta di credito, i cui dati siano stati comunicati dal titolare carta all'esercente via mail, telefono, ecc…

Le soluzioni Server to Server sono subordinate all'ottenimento della certificazione di sicurezza PCI DSS (questionario SAQ D).

Per utilizzare questa funzionalità, è necessario dichiarare un codice di richiesta per intercettare il risultato dell'attività all'interno dell'Activity desiderata:

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

Gestire il risultato dell'attività all'interno della tua 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
}
}
                                