Alteração de senha
stable
Este endpoint possibilita que o cliente do parceiro Bankly possa alterar a senha do seu cartão.
Pré-requisito
Para que seja possível utilizar este endpoint, é necessário que:
- O cliente do parceiro Bankly possua um cartão ativo/bloqueado.
Requisição
Requisição HTTP
PATCH https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/password}
--request PATCH \
--url 'https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/password' \
--header 'Authorization: Bearer {Token}' \
--header 'accept: application/json' \
--header 'api-version: 1.0' \
--header 'content-type: application/json' \
--data '{
"password": "5819"
}'
Autorização
Para garantir a segurança nas requisições, todos os endpoints do Bankly utilizam scopes como parte do seu fluxo de autorização.
Esta requisição requer o scope descrito a seguir:
Scope | Descrição |
---|---|
card.pci.password.update | Concede acesso para alterar a senha de um cartão. |
Cabeçalhos (Headers)
Nome | Descrição |
---|---|
api-version | Obrigatório. Versão da API. Atualmente estamos na versão 1.0. |
Authorization | Obrigatório. Token de autorização do tipo Bearer. |
Parâmetros da rota (Path)
No path desta requisição envie os seguintes campos:
Nome | Tipo | Descrição |
---|---|---|
proxy | path | Obrigatório. Código identificador do cartão. |
Corpo da requisição (Body)
No body, envie os seguintes campos em formato JSON:
Nome | Tipo | Descrição |
---|---|---|
password | string | Obrigatório. Senha de uso do cartão. A senha deve possuir 4 dígitos. |
Atenção
Para maior segurança, não utilize a senha atual e nem uma data de aniversário. A senha não deve conter números sequenciais (Ex. 1234 ou 8765) ou repetidos (Ex. 1111).
{
"password": "5819",
}
Resposta (Response)
O status code 200 indicará que a solicitação foi aceita e que a senha foi alterada com sucesso.
Dica
Para simular uma requisição nesse endpoint, acesse o API Reference.
Erros
Este endpoint pode retornar erros específicos, conforme a tabela a seguir:
Status Code | Código | Descrição |
---|---|---|
409 | 029 | O processo de criação do cartão não foi finalizado. |
409 | CARD_HAS_PINOFFILINE | Não é possível alterar a senha de cartão PIN offline. |
Válido lembrar que a API também poderá retornar erros comuns entre todos os endpoints.
Eventos
Este endpoint não possui eventos relacionados a ele.
Updated about 1 month ago