Pular para o conteúdo principal

Atualizar CVV

Envie um novo valor de verificação do cartão para um cartão salvo pertencente ao usuário autenticado.

Domínio
Cards and vault
Serviço responsável
Payments
Destinado a
Aplicativo do cliente · usuário para servidor
Autorização compatível
Token Bearer do usuário autenticado

Headers#

2
AuthorizationstringObrigatório
Aceito ou encaminhado pelo API Gateway para esta operação.
X-Merchant-IDstringOpcional
Aceito ou encaminhado pelo API Gateway para esta operação.

Parâmetros de rota#

2
user_idstring<uuid>Obrigatório
Valor que substitui `user_id` na rota do endpoint.
card_idstring<uuid>Obrigatório
Valor que substitui `card_id` na rota do endpoint.

Corpo da solicitação#

1
card_cvvstringObrigatório
Payload JSON aceito pelo serviço responsável. Use o painel de solicitação para editar e visualizar o corpo.
Exemplo 123

Resposta#

7
204A solicitação foi aceita ou concluída. Confira o payload para o resultado de negócio.
400A solicitação é inválida ou falhou na validação.
401As credenciais ou o contexto do chamador são inválidos.
403As credenciais ou o contexto do chamador são inválidos.
404O recurso ou a rota solicitada não foi encontrado.
422A solicitação é inválida ou falhou na validação.
500O serviço não concluiu a solicitação. Tente novamente apenas quando a operação for segura ou idempotente.

Antes de atualizar o CVV#

  • Autentique o cliente e envie seu token de acesso de usuário no cabeçalho Authorization.
  • Defina o ID de usuário da rota como o UUID do cliente autenticado e use um ID de cartão retornado por Listar cartões armazenados.
  • Solicite ao cliente o valor de verificação do cartão (CVV) do cartão salvo. O cartão deve pertencer a esse cliente e ter uma data de validade válida.

Envie a solicitação de atualização#

Use a URL base de sandbox abaixo para testes e https://api.deuna.io para produção. Envie um objeto JSON com a string obrigatória card_cvv contendo o CVV de três ou quatro dígitos. Não há parâmetros de consulta. Esta operação atualiza um cartão existente; não cria um cartão nem cobra o cliente.

curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/USER_ID/cards/CARD_ID/refresh-cvv' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"card_cvv":"123"}'

Verifique o resultado#

Uma solicitação bem-sucedida retorna HTTP 204 No Content com corpo vazio. Não o interprete como JSON. A resposta confirma a conclusão da atualização do CVV; não confirma um pagamento nem expõe o CVV em uma resposta de cartão. Não é necessário um webhook de pagamento para confirmar esta operação.

Continue com sua solicitação de pagamento quando o cliente estiver pronto para pagar.

Trate erros e novas tentativas#

HTTP 400 indica identificadores inválidos, JSON malformado ou CVV ausente ou inválido. HTTP 401 indica autorização de usuário inválida. HTTP 404 significa que o cartão salvo não foi encontrado para o usuário autenticado. HTTP 422 indica cartão vencido, dados de validade inválidos ou um cartão cujo CVV não pode ser atualizado. Corrija os dados ou selecione outro cartão antes de tentar novamente.

Se um tempo limite ou erro do servidor deixar o resultado incerto, não reenvie o CVV automaticamente. Não há contrato de chave de idempotência definido para esta operação. Permita que o cliente tente novamente no fluxo ativo e solicite o CVV novamente quando necessário. Consulte códigos de resposta e solução de problemas.