DDA

Ativar 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

Escopos requeridos

dda/write

← Anterior

Extrato conta master

Consultar inscrição no DDA

const url = 'https://sandbox.validapay.com.br/v1/dda/subscription';

const options = {
  method: 'POST',
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

201Inscriçã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"
}

409Já inscrito▾

JSON

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

409Inscriçã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"
    }
}

403Indisponí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"
    }
}

400Erro do provedor▾

JSON

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

← Anterior

Extrato conta master

Consultar inscrição no DDA