VCNAtualizar VCN (Em breve)

Atualizar VCN (Em breve)

🚧 Em breve — este endpoint ainda não está disponível em Sandbox nem Produção. A documentação está publicada para você preparar a integração; avisaremos no changelog quando entrar no ar.

Atualiza uma VCN CUSTOM já emitida sem trocar o cartão — o PAN continua o mesmo. É por aqui que se faz a recarga do teto e a prorrogação (ou o encurtamento) da validade. Envie só o que quer mudar (pelo menos um campo); campo não enviado não muda. VCNs AERIAL e HOTEL não são atualizáveis — os controles delas derivam da reserva (409 vcn-not-updatable).

⚠️ limit.value é o teto ACUMULADO da janela — não é saldo nem incremento. O disponível é calculado pela rede do cartão (disponível = teto − consumido). Para adicionar crédito, envie novo total = teto vigente + crédito. Ex.: teto 100.01 e nova venda de R$ 80 → envie 180.01; enviar 80.00 derruba o teto para baixo do que já foi gasto e toda captura passa a ser recusada. A resposta devolve o teto vigente para você fechar o loop; com recargas em paralelo, use limit.expectedValue.

As regras de cada campo estão documentadas no próprio campo, abaixo; o comportamento de cada erro, em Respostas.

curl -X PATCH "https://api-sandbox.contasimples.com/credit-cards/v1/vcns/01JQ8ZP4C7D9F1G3H5J7K9L2MN" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "limit": {
    "value": 350,
    "expectedValue": 0.01
  }
}'
{
  "vcnId": "01JQ8ZP4C7D9F1G3H5J7K9L2MN",
  "limit": {
    "value": 350,
    "currency": "BRL"
  },
  "endDate": "2026-10-27",
  "maxPurchaseQuantity": 10000,
  "updatedAt": "2026-08-24T09:15:40.000Z"
}
PATCH
/credit-cards/v1/vcns/{vcnId}
PATCH
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN
path
vcnIdstring
Required

Identificador do VCN retornado na emissão (campo vcnId).

Content-Typestring
Required

The media type of the request body

Options: application/json
limitobject

Recarga ou ajuste do teto de gasto.

endDatestring

Novo fim da janela de uso, YYYY-MM-DD — o mesmo nome do campo na emissão. Pode subir e descer. Deve ser futuro e nunca além de 365 dias da emissão — o teto conta da emissão, então recargas não empurram a validade. Mexer no limit não muda a validade: para os dois, envie os dois campos.

Format: date
maxPurchaseQuantityinteger

Número máximo de autorizações, até 100000.

Min: 1 • Max: 100000
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN

Path Parameters

vcnIdstring
Required

Identificador do VCN retornado na emissão (campo vcnId).

Example:
01JQ8ZP4C7D9F1G3H5J7K9L2MN

Body

application/json
limitobject

Recarga ou ajuste do teto de gasto.

endDatestring

Novo fim da janela de uso, YYYY-MM-DD — o mesmo nome do campo na emissão. Pode subir e descer. Deve ser futuro e nunca além de 365 dias da emissão — o teto conta da emissão, então recargas não empurram a validade. Mexer no limit não muda a validade: para os dois, envie os dois campos.

Example:
2026-11-15
maxPurchaseQuantityinteger

Número máximo de autorizações, até 100000.

Example:
10000

Responses

vcnIdstring
Required

Eco do identificador.

limitstring
Required

Teto vigente após a operação — guarde-o e some o próximo crédito sobre ele.

endDatestring
Required

Fim da janela de uso vigente, YYYY-MM-DD — o mesmo nome e o mesmo formato do campo na emissão.

maxPurchaseQuantityinteger
Required

Valor efetivo vigente.

updatedAtstring
Required

Carimbo desta atualização (UTC).