---
title: "Submit a country activation request for a customer"
method: POST
path: "/open-api/v3/scan2pay/customer/active"
tags: ["Customer"]
---

# Submit a country activation request for a customer

`POST /open-api/v3/scan2pay/customer/active`

## Request

- Base URL: `https://api-sandbox.interlace.money`
- URL: `https://api-sandbox.interlace.money/open-api/v3/scan2pay/customer/active`
- Auth: API key in header `x-access-token`

Submits a request to enable Scan-to-Pay for the specified customer
in the specified transaction country. The response returns the
activation status for that transaction country, which may be
PROCESSING, ACTIVATED, or REJECTED.

For the request structure, see the
[Activate Customer Request Resource](https://developer.interlace.money/docs/scan-to-pay#activate-customer-request-resource).
For the response structure, see the
[Country Activation Resource](https://developer.interlace.money/docs/scan-to-pay#country-activation-resource).

## Request body

- ActiveReqDTO
  - `transactionCountry` string, required: Transaction country code to activate (ISO 3166-1 alpha-2)
  - `customerId` string, required: Numeric string representing a 64-bit Interlace customer identifier

## Response `200`

Successful operation

- ApiResultCountryActivationRespDTO: Standard API response wrapper
  - `code` string: Business code, 000000 means success
  - `message` string: Message description
  - `data` CountryActivationRespDTO: Response data, null if error
    - `customerId` string: Numeric string representing a 64-bit Interlace customer identifier
    - `transactionCountry` string: Transaction country code (ISO 3166-1 alpha-2)
    - `status` string: Country activation status(PROCESSING, SUCCESS, FAILED)
    - `errorMessage` string: Reason for rejection or processing failure, if applicable
    - `missingMaterials` KycMissingMaterial[]: KYC items that must be provided or corrected before activation can be completed
      - `fieldName` string: Field name in the KYC submission payload
      - `description` string: Description of the issue
      - `issueType` string: Issue category
      - `suggestedAction` string: Recommended remediation action

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/interlace/apis/scan-to-pay.md) - [All operations](https://skmtc.dev/interlace/apis/scan-to-pay/llms.txt) - [OpenAPI document](https://skmtc.dev/interlace/apis/scan-to-pay/revisions/81f4c583068b?raw)