On This Page

{#jumplink-list}  
[Markdown](/docs/vas/en-us/sis-pax/integration/all/rest/sis-pax/semi-integrated-pymnt-svcs-intro/semi-integrated-ad-app-retrieve-rootca-cert-intro.md)  
Filter  
FILTER BY TAG

Retrieving the Root CA Certificate {#semi-integrated-ad-app-retrieve-rootca-cert-intro}
=======================================================================================

When the app is operating in Local mode, you can validate the Acceptance Devices app server's certificate by adding the Root CA certificate to your trust store. This action is required if you want to use an mTLS connection. For more information, see [Activating a Secure mTLS Connection](/docs/vas/en-us/sis-pax/integration/all/rest/sis-pax/semi-integrated-pymnt-svcs-intro/sis-activate-mtls-connection-intro.md "").  
You can retrieve the Root CA certificate in the `Business Center` or by using a REST API request.

Retrieve the Root CA Certificate in the `Business Center` {#sis-ad-app-retrieve-rootca-cert-ebc}
================================================================================================

Follow these steps to retrieve the Root CA certificate in the Business Center:

1. In the `Business Center`, go to the left navigation panel and choose Acceptance Devices \> Activation Codes. The Activation Codes page appears.
2. Click Download Root CA Certificate. When the download is complete, the browser window shows a download completion message.
3. In the local folder directory of your computer, navigate to the Download folder to access the Root CA certificate file.

Retrieve the Root CA Certificate Using a REST API Request {#semi-integrated-ad-app-retrieve-rootca-cert-task}
=============================================================================================================

You can use a REST API request to retrieve the Acceptance Devices app server's Root CA certificate when the app is operating in Local mode. You would then add the certificate to your trust store.  
You must authenticate each API request you send to a `Visa Acceptance Solutions` API by using 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.visaacceptance.com/docs/vas/en-us/platform/developer/all/rest/rest-getting-started/restgs-intro.md "").

Endpoints
---------

**Test:** `GET ``https://apitest.visaacceptance.com``/dms/v2/devices/certificates/rootca`  
**Production:** `GET ``https://api.visaacceptance.com``/dms/v2/devices/certificates/rootca`

Required Fields to Retrieve the Root CA Certificate Using a REST API Request {#semi-integrated-ad-app-retrieve-rootca-cert-api-reqfields}
=========================================================================================================================================

The body of the API request is empty.

REST Example: Retrieve the Root CA Certificate Using a REST API Request {#semi-integrated-ad-app-retrieve-rootca-cert-api-ex-rest}
==================================================================================================================================

Request  
The body of the request is empty.

```
{
}
```

Response to a Successful Request  
The response includes a PEM--encoded certificate chain.

```
{
    "certificateChain": "-----BEGIN CERTIFICATE-----Your certificate response data appears here.-----END CERTIFICATE-----"
}
```

RELATED TO THIS PAGE