---
title: "Segunda via de cartão"
method: POST
path: "/cards/{proxy}/duplicate"
tags: ["Emissão de cartão"]
---

# Segunda via de cartão

`POST /cards/{proxy}/duplicate`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/duplicate`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Crie uma segunda via de um cartão físico com as mesmas características da primeira via.</p>
  <span class="bkly-ref-small-stable-tag">stable</span>
  <span class="bkly-ref-scope-tag">scope: card.create</span>
</div>
[block:callout]
{
  "type": "warning",
  "title": "Importante",
  "body": "O cancelamento da primeira via 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. Confira a documentação [Emissão de segunda via](/docs/emissao-segunda-via) para mais informações."
}
[/block]

## Path parameters

- `proxy` string, required

## Headers

- `api-version` string, required: Versão da API. Atualmente estamos na versão 1.0.
- `Authorization` string, required: <em>Token</em> de autorização do tipo Bearer.

## Request body

- CreateDuplicateCardRequest
  - `status` 'LostMyCard' | 'CardWasStolen' | 'CardWasDamaged' | 'CardNotDelivered' | 'UnrecognizedOnlinePurchase' | 'CustomerOrder' | 'CardWasBroken' | 'CardHasDefect' | 'CardWasRobbed' | 'ProgramMigration', required: Motivo da emissão da segunda via. ProgramMigration indica que a solicitação de 2ª via está associada a uma migração de programa.
  - `cancellationMode` 'Default' | 'Immediately' | 'Later': Campo que indica o momento do cancelamento da primeira via. Para mais informações, consulte a tabela "Momento do cancelamento da primeira via" na documentação de Emissão de segunda via.
  - `documentNumber` string, required: Número de documento de CPF ou CNPJ (informe somente números).
  - `cardName` string: Nome que será impresso no cartão. Importante: caso o campo não seja enviado, será considerado o cardName existente na via original.
  - `alias` string: Apelido do cartão. Importante: caso o campo não seja enviado, será considerado o alias existente na via original.
  - `description` string, required: Detalhes do cancelamento com qualquer informação considerada relevante.
  - `password` string, required: Senha do cartão atual (primeira via) para realizar transações. Preencha com quatro dígitos numéricos. Exemplo: '9348'.
  - `resetPassword` boolean: Indica se o sistema deve gerar uma nova senha aleatória para o cartão durante a solicitação de segunda via (true) ou se deve manter a senha atual (false). Importante: caso este campo não seja preenchido, será adotado o valor padrão (false). Para que o parceiro possa utilizar este campo, é necessário avaliação prévia pelo time de segurança do Bankly e que o usuário tenha acesso à senha (pelo kit enviado ou pelo endpoint de consulta de senhas).
  - `transferToken` boolean: Indica se deve ou não ser realizada a transferência de tokens de carteira digital para o novo cartão na emissão da segunda via. Importante: caso este campo não seja preenchido, será adotado o valor padrão (`true`), transferindo automaticamente todos os tokens para o novo cartão.
  - `address` AddressRequest: Objeto que deverá conter informações sobre o endereço do titular do cartão.
    - `zipCode` string, required: Código postal de endereço. Informe somente números. O CEP deve ser nacional.
    - `address` string, required: Logradouro (nome da rua, avenida etc.).
    - `number` string, required: Número do imóvel.
    - `complement` string: Complemento do endereço.
    - `neighborhood` string, required: Nome do bairro.
    - `city` string, required: Nome da cidade.
    - `state` string, required: Nome do estado. Formato ISO 3166-2:BR.
    - `country` string, required: Nome do país. Formato ISO 3166-2:BR.
  - `metadata` object: Objeto que deverá conter informações adicionais pertinentes ao contexto, representadas por meio de pares de chave e valor.

## Response `202`

Cartão

- CardBuildingResponse
  - `proxy` string: Código identificador do cartão.
  - `activateCode` string: Código para ativar o cartão.

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `406` (unresolved $ref)
- `409` (unresolved $ref)
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/gest-o-de-cart-es.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-cart-es/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-cart-es/revisions/1116211d65a0?raw)