Activating a Terminal in the Acceptance Devices App {#semi-integrated-solution-ad-app-activate-terminal-intro}
==============================================================================================================

To process payments on your PAX device using the Acceptance Devices app and your point-of-sale (POS) system, you must activate a terminal in the Acceptance Devices app by using an activation code. You can generate the code in the `Business Center` or by using an API request. After generating the activation code, you must enter it in the Acceptance Devices app.

Generate a Terminal Activation Code in the `Business Center` {#semi-integrated-ad-app-activation-code-ebc}
==========================================================================================================

The terminal activation code that you generate in the `Business Center` is valid for 24 hours.  
Follow these steps to generate a terminal activation code.

1. In the `Business Center`, go to the left navigation panel and choose Acceptance Devices \> Activation Codes. The Activation Codes page appears.
2. Click the Select Transacting MID drop-down menu.
3. Choose a transacting MID from the list.
4. Click the Select number of Activation Codes drop-down menu.
5. Choose the number of activation codes that you want to generate. The maximum number of codes is 15.
6. Click Generate. The activation codes display on the page. To copy the codes to your clipboard, click the icon next to the code.
7. To download a text file containing the activation codes, click the Download codes as a .txt file button.
8. Navigate to the Download folder on your computer to access the text file.

Generate a Terminal Activation Code Using a REST API Request {#semi-integrated-ad-app-activation-code-api-intro}
================================================================================================================

Before activating the terminal in the Acceptance Devices app, you must generate a terminal activation code.  
You can use a REST API request to generate a terminal activation code, which is valid for 24 hours.  
You must authenticate each request that you send to a `Cybersource` API. In order to authenticate an API request, you can use a REST shared secret key or a REST certificate. For more information about authentication requirements, see the [*Getting Started with REST Developer Guide*](https://developer.cybersource.com/docs/cybs/en-us/platform/developer/all/rest/rest-getting-started/restgs-intro.md "").

Endpoints
---------

The POST request must include the transacting merchant ID (MID) that is sending the request and the quantity of activation codes to be generated. You can request up to 15 activation codes in a single request.  
**Test:** `POST ``https://apitest.cybersource.com``/dms/v2/merchants/{transacting mid}/activation-codes?size={number of activation codes}`  
**Production:** `POST ``https://api.cybersource.com``/dms/v2/merchants/{transacting mid}/activation-codes?size={number of activation codes}`

Required Fields for Generating a Terminal Activation Code {#semi-integrated-ad-app-activation-code-api-reqfields}
=================================================================================================================

The body of the API request is empty. The POST request must include the information required to return the response.

REST Example: Generating a Terminal Activation Code {#semi-integrated-ad-app-activation-code-api-ex-rest}
=========================================================================================================

Request  
The body of the request is empty. The POST request includes the information required to return the response.

```
{
}
```

Response to a Successful Request  
The response includes the activation code (token field) and the amount of time (ttl field) that the activation code is valid. The ttl field value is shown in milliseconds. The activation code is valid for 24 hours.

```
{
    "tokens": [
        {
            "token": "%N5wU2jH",
            "ttl": 86399805
        }
    ]
}
```

Enter an Activation Code in the Acceptance Devices App {#semi-integrated-solution-ad-app-enter-activation-code}
===============================================================================================================

Before activating a terminal, you must generate a terminal activation code for the device in the `Business Center` or by using a REST API request. The activation code is valid for 24 hours. Follow these steps to enter a terminal activation code in the Acceptance Devices app.

1. On the Device Activation screen, enter the activation code that you generated. Tap Continue.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/card-processing/semi-integrated-solution/images/sis-activating-terminal-1.png/jcr:content/renditions/original)
2. When the activation code is accepted, the Activation Successful screen appears. Tap Confirm.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/card-processing/semi-integrated-solution/images/sis-activating-terminal-2.png/jcr:content/renditions/original)

#### AFTER COMPLETING THE TASK

If you are using the app in Local mode with Mutual Transport Layer Security (mTLS) enabled, you must activate a secure mTLS connection between your point-of-sale (POS) system and the Android device in the Acceptance Devices app. See [Activating a Secure mTLS Connection](/docs/cybs/en-us/sis-pax/integration/all/rest/sis-pax/semi-integrated-pymnt-svcs-intro/sis-activate-mtls-connection-intro.md "").  
If you are using the app in Local mode with Transport Layer Security (TLS) enabled or in Cloud mode, you must start the Acceptance Devices app server. See [Start the Acceptance Devices App Server](/docs/cybs/en-us/sis-pax/integration/all/rest/sis-pax/semi-integrated-solution-pax-get-started-intro/semi-integrated-ad-app-starting-server-intro/semi-integrated-ad-app-start-server.md "").