> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/nfc-wallet-sdk-android/es/implement-nfc-wallet/make-payment/implement-contactless-payments/1.-implement-hce-service.md).

# 1. Implementar el servicio HCE

## Resumen

El SDK de NFC Wallet admite la emulación de tarjetas por host (HCE) en Android. Permite la emulación de tarjetas NFC e intercambiar APDUs con un terminal POS a través de NFC.

Para más detalles, consulte la documentación de Android: [Descripción general de la emulación de tarjetas basada en host](https://developer.android.com/develop/connectivity/nfc/hce).

Para continuar, primero implemente un servicio HCE como se describe en esta sección.

Después de registrar el servicio, verifique que aparezca bajo **Tocar y pagar** en la configuración de Android.

## Integración del SDK

### Extender `AsyncHCEService`

Para manejar pagos sin contacto, habilite el procesamiento de APDU extendiendo `AsyncHCEService`.

No necesita anular ningún método.

Use las anulaciones solo si desea registrar o personalizar el manejo de APDU.

```java
public class MyHCEService extends AsyncHCEService {

    // Anular 'processCommandApdu' es opcional
    // La aplicación de billetera digital puede capturar el tiempo de procesamiento de APDU.
    @Override
    public byte[] processCommandApdu(byte[] inputApdu, Bundle bundle) {
        // Devuelve el valor del SDK (siempre 'null').
        // El procesamiento de APDU es asincrónico.
        // El SDK envía automáticamente la APDU de respuesta al terminal POS.
        return super.processCommandApdu(inputApdu, bundle);
    }

    // Anular 'onApduResponse' es opcional
    // La aplicación de billetera digital puede inspeccionar o anular la APDU de respuesta.
    @Override
    public boolean onApduResponse(final byte[] inputApdu, final Bundle extras, final byte[] responseApdu){
        // La aplicación de billetera digital puede registrar responseApdu.

        // Si desea anular la respuesta y responder al terminal POS:
        // 1. modificar la responseAPDU
        // 2. sendResponseApdu(modifiedResponseApdu);
        // 3. return true; indica al SDK que la respuesta ya fue enviada.

        // De lo contrario, devuelva false y permita que el SDK envíe responseApdu.
        return false;
    }
}
```

{% hint style="info" %}
El SDK de NFC Wallet suspende el procesamiento de APDU cuando se requiere autenticación.

El procesamiento de APDU se reanuda después de que la autenticación tiene éxito, se aborta o el servicio HCE se desactiva.
{% endhint %}

{% hint style="danger" %}
Algunos dispositivos bloquean los lanzamientos en segundo plano de una `Actividad` para el aviso de autenticación de paso adicional. Esto puede bloquear los pagos sin contacto hasta que usted llame a `deactivate()`.

Su aplicación de billetera digital puede implementar un tiempo de espera y llamar a `deactivate()` para desbloquear el flujo de pago sin contacto.
{% endhint %}

### Registre el servicio en `AndroidManifest.xml`

Registre su servicio HCE (la clase que extiende `AsyncHCEService`) como `HOST_APDU_SERVICE` en su manifiesto.

```xml
<!-- El nombre del servicio debe coincidir con la estructura de su paquete. -->
<service android:name="com.mycompany.myapplication.myservices.MyHCEService"
  android:exported="true"
  android:label="@string/app_name"
  android:permission="android.permission.BIND_NFC_SERVICE">
  <intent-filter>
    <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE" />
  </intent-filter>
  <meta-data
    android:name="android.nfc.cardemulation.host_apdu_service"
    android:resource="@xml/apduservice"/>
</service>
```

{% hint style="info" %}
Crear `apduservice.xml` en `res/xml` para declarar los AID compatibles.
{% endhint %}

### Declarar AIDs compatibles

Crear `apduservice.xml` en `res/xml`.

Declare el AID PPSE y los AIDs de la red de pagos que soporte.

```xml
 <?xml version="1.0" encoding="utf-8"?>
<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
  android:description="@string/hce_service_description"
  android:requireDeviceUnlock="false"
  android:apduServiceBanner="@drawable/hce_banner">
  <aid-group
    android:description="@string/aid_description"
    android:category="payment">
    <!-- AID PPSE requerido -->
    <aid-filter android:name="325041592E5359532E4444463031"/>
    <!-- AIDs de Mastercard -->
    <aid-filter android:name="A0000000041010"/>
    <aid-filter android:name="A0000000043060"/>
    <aid-filter android:name="A0000000042010"/>
    <!-- AIDs de Visa -->
    <aid-filter android:name="A0000000031010"/>
    <aid-filter android:name="A0000000980840"/>
    <aid-filter android:name="A0000000032020"/>
    <aid-filter android:name="A0000000032010"/>
    
  </aid-group>
</host-apdu-service>
```

En el ejemplo anterior:

* El AID PPSE requerido es:
  * `325041592E5359532E4444463031`
* Los AIDs de Mastercard son:
  * `A0000000041010`
  * `A0000000043060`
  * `A0000000042010`
* Los AIDs de Visa son:
  * `A0000000031010`
  * `A0000000980840`
  * `A0000000032020`
  * `A0000000032010`

{% hint style="info" %}
La lista de AID depende de su programa NFC Wallet. Confirme la lista con su representante de la red de pagos.
{% endhint %}

### Verificar la configuración de Tocar y pagar

Después de registrar el servicio HCE en `AndroidManifest.xml`, aparece bajo **Tocar y pagar** en la configuración de Android.

Para verificar:

1. Abra **Configuración** en el dispositivo.
2. Vaya a **Tocar y pagar**.
3. Confirme que su aplicación aparece en la lista.

<figure><img src="/files/189bc938d14d1c4e63b92a58972be56b82acb831" alt="" width="375"><figcaption><p>Configuración de Android que muestra la aplicación listada en Tocar y pagar.</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/nfc-wallet-sdk-android/es/implement-nfc-wallet/make-payment/implement-contactless-payments/1.-implement-hce-service.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.