Emissão de segunda via

Este endpoint permite que o parceiro Bankly ofereça a seus clientes a possibilidade de emitir uma segunda via do cartão físico ou virtual (caso este seja atrelado a um físico) com as mesmas características da primeira via.

Por meio deste endpoint, também é possível realizar a emissão de uma nova via para um cartão que já se encontra cancelado.

Cancelamento

O cancelamento da primeira via (ou via anterior) poderá ser realizado de forma imediata ou tardia. Quando ocorre de forma tardia, o cancelamento se dá no momento da ativação da nova via.

👍

Dica

Para mais informações sobre o cancelamento imediato ou tardio, consulte a tabela Motivos de solicitação de segunda via do cartão.

Requisição (Request)

Requisição HTTP

POST https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/duplicate

--request POST \ 
--url 'https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/duplicate' \ 
--header 'Authorization: Bearer {{Token}}' \ 
--header 'accept: application/json' \ 
--header 'api-version: 1.0' \ 
--header 'content-type: application/json' 
--data '{
      "status": "CardWasStolen",
      "cancellationMode": "Default",
      "documentNumber": "47742663023",  
      "password": "1234",  
      "resetPassword": true,
      "description": "Lorem ipsum",     
      "address": {  
            "zipCode": "68060100",  
            "address": "Rua 6 de Março",  
            "number": "2500",  
            "neighborhood": "Alter do Chão",  
            "complement": "",  
            "city": "Santarém",  
            "state": "PA",  
            "country": "BR"  
      },
      "metadata":{
            "updatedAt": "2022-12-30T01:11:07.4019873Z",
            "versao": "1.0"
      }
}'

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:

Cabeçalhos (Headers)

Parâmetros da rota (Path)

No path desta requisição, envie os seguintes campos:

Corpo da requisição (Body)

No body, envie os seguintes campos em formato JSON:

📘

Nota

Para que o parceiro possa utilizar o campo resetPassword, é necessário que seja feita uma avaliação pelo time de segurança do Bankly e que o usuário tenha acesso à senha, seja pelo kit enviado, seja pelo endpoint de consulta de senhas.

Caso o cliente não possua um endereço cadastrado, preencha:

Entretanto, caso o cliente já possua um endereço cadastrado, o preenchimento do campo address é opcional.

❗️

Atenção

Para evitar problemas na entrega devido à desatualização do endereço cadastrado, recomendamos que o campo address seja preenchido mesmo que o cliente já tenha informado um endereço previamente.

{
      "status": "CardWasStolen",
      "cancellationMode": "Default",
      "documentNumber": "47742663023",  
      "password": "1234",  
      "resetPassword": true,
      "description": "Lorem ipsum",     
      "address": {  
            "zipCode": "68060100",  
            "address": "Rua 6 de Março",  
            "number": "2500",  
            "neighborhood": "Alter do Chão",  
            "complement": "",  
            "city": "Santarém",  
            "state": "PA",  
            "country": "BR"  
      },
      "metadata":{
            "updatedAt": "2022-12-30T01:11:07.4019873Z",
            "versao": "1.0"
      }
}

Motivos de solicitação de segunda via do cartão (status)

Após realizar a requisição, o status do cartão antigo será atualizado de acordo com o motivo informado no campo status descrito acima. Os valores correspondentes podem ser visualizados na tabela abaixo:

Momento do cancelamento da primeira via (cancellationMode)

🚧

Importante

Não é possível enviar os valores “Immediately” e/ou “Later” no campo cancellationMode em caso de emissão de nova via para um cartão que já havia sido cancelado. Nesses casos, deve-se informar “CanceledAlready” ou “Default” (que irá considerar o valor “CanceledAlready” automaticamente).

Resposta (Response)

Os status code 202 indica que a solicitação foi aceita e o cartão está sendo criado.

Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:

{ 
  "proxy": "2370021007715002820", 
  "activateCode": "A0DDDC0951D1" 
} 

👍

Dica

Para simular uma requisição nesse endpoint, acesse o API Reference.

Erros

Este endpoint pode retornar alguns erros específicos, conforme a tabela a seguir:

Recordamos que esta API também poderá retornar erros comuns entre todos os endpoints. Portanto, recomendamos a consulta da documentação de erros, onde é possível encontrar as mensagens comuns em inglês que acompanham os erros 400 (se houver).

Eventos

Caso o parceiro deseje receber mensagens referentes aos eventos relacionados a esse endpoint, é preciso configurar o webhook. Os eventos são: