DDA

Consultar inscrição no DDA

Retorna a inscrição da conta e o estado em que ela está. Use para saber se já dá para listar boletos.

GET/v1/dda/subscription

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

Escopos requeridos

dda/read

← Anterior

Ativar DDA

Desativar DDA

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

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

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

Response Examples

200Sucesso▾

JSON

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

404Sem inscrição▾

JSON

{
    "error": {
        "message": "Conta não possui inscrição no DDA",
        "code": "DDA_SUBSCRIPTION_NOT_FOUND",
        "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"
    }
}

← Anterior

Ativar DDA

Desativar DDA