# Ativar DDA

**Área:** DDA

Inscreve o CPF/CNPJ da conta no DDA (Débito Direto Autorizado). A inscrição entra em `PROCESSING` e a confirmação chega por webhook alguns minutos depois. Não há corpo na requisição: o documento vem da conta autenticada.

`POST /v1/dda/subscription`

**Base URL Produção:** `https://api.validapay.com.br`  
**Base URL Sandbox:** `https://sandbox.validapay.com.br`

**Scopes necessários:** `dda/write`

### Resposta 201: Inscrição criada

```json
{
    "accountNumber": "460851686",
    "documentNumber": "12345678901",
    "status": "PROCESSING",
    "celcoinSubscriptionId": "a1b2c3d4-0000-0000-0000-000000000000",
    "errorMessage": null,
    "createdAt": "2026-10-03T14:58:12.004Z",
    "updatedAt": "2026-10-03T14:58:12.004Z"
}
```


### Resposta 409: Já inscrito

```json
{
    "error": {
        "message": "Conta já possui inscrição no DDA",
        "code": "DDA_ALREADY_SUBSCRIBED",
        "details": null,
        "timestamp": "2026-10-07T12:32:37.043Z"
    }
}
```


### Resposta 409: Inscrição em processamento

```json
{
    "error": {
        "message": "Inscrição no DDA ainda em processamento",
        "code": "DDA_SUBSCRIPTION_PROCESSING",
        "details": null,
        "timestamp": "2026-10-07T12:32:37.043Z"
    }
}
```


### Resposta 403: Indisponível em sandbox

```json
{
    "error": {
        "message": "Não disponível em ambiente de Sandbox",
        "code": "DDA_NOT_AVAILABLE_IN_SANDBOX",
        "details": null,
        "timestamp": "2026-10-07T12:32:37.043Z"
    }
}
```


### Resposta 400: Erro do provedor

```json
{
    "error": {
        "message": "Erro ao comunicar com o provedor",
        "code": "DDA_PROVIDER_ERROR",
        "details": null,
        "timestamp": "2026-10-07T12:32:37.043Z"
    }
}
```


---

Página: https://docs.validapay.com.br/referencia/post-ativar-dda  
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json