---
title: "Emissão de cartão adicional"
method: POST
path: "/cards-pci/{proxy}/additional"
tags: ["Emissão de cartão"]
---

# Emissão de cartão adicional

`POST /cards-pci/{proxy}/additional`

## Request

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

<div class="bkly-ref-description">
  <p>Este endpoint permite que o parceiro Bankly ofereça a seus clientes a possibilidade de solicitar um cartão adicional.</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": "Para realizar a configuração do programa do cartão, o parceiro deve procurar o time de Operações da Bankly."
}
[/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

- CreateAdditionalCardRequest
  - `cardName` string, required: Nome que será impresso no cartão. <b>Importante</b>: caso o campo não seja enviado, será considerado o <code>cardName</code> existente na via original.
  - `alias` string, required: Apelido do cartão. <b>Importante</b>: caso o campo não seja enviado, será considerado o <code>alias</code> existente na via original.
  - `password` string, required: Senha do cartão atual (primeira via) para realizar transações (preencha com quatro campos números. Exemplo: '9348').
  - `additional` AdditionalRequest, required: Objeto que contém informações sobre o cartão adicional.
    - `holder` AdditionalHolder, required: Objeto com informações sobre o portador do cartão adicional.
      - `name` string, required: Nome do portador do cartão adicional.
      - `document` Document, required: Objeto que deverá conter informações sobre o documento titular do cartão.
        - `value` string, required: Número do documento do titular do cartão.
        - `type` string, required: Tipo do documento utilizado (CPF ou CNPJ).
  - `holder` HolderRequest, required: Objeto que contém informações sobre o titular do cartão.
    - `document` Document, required: Objeto que deverá conter informações sobre o documento titular do cartão.
      - `value` string, required: Número do documento do titular do cartão.
      - `type` string, required: Tipo do documento utilizado (CPF ou CNPJ).
    - `password` string, required: A senha deve possuir quatro dígitos e ser transmitida criptografada em formato base64. Exemplo: "AiHJpKM2w4w31..."
  - `adress` 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

- `404` (unresolved $ref)
- `409` (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)