---
title: "Cartão físico múltiplo"
method: POST
path: "/cards/multiple"
tags: ["Emissão de cartão"]
---

# Cartão físico múltiplo

`POST /cards/multiple`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/cards/multiple`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Crie um cartão físico múltiplo (pré e pós) que será embossado e entrege no endereço informado pelo cliente.</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 cartão múltiplo tem como principal característica ter no mesmo plástico um número pré e um pós. Porém, um dos números ficará adormecido enquanto o outro estiver ativo. Confira a documentação [Emissão de cartão múltiplo](/docs/emissao-cartao-multiplo) para mais informações."
}
[/block]

## 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.

## Parameters

- `#/paths/~1cards~1virtual/post/parameters/2` (unresolved $ref)

## Request body

- CreateCardRequestMultiple
  - `documentNumber` string, required: Número de documento de CPF ou CNPJ (informe somente números). Tamanho máximo de 14 caracteres.
  - `cardName` string, required: Nome que será impresso no cartão (não será permitido o uso de números e caracteres especiais). Tamanho máximo de 19 caracteres.
  - `alias` string, required: Apelido do cartão (não será permitido o uso de caracteres especiais e o tamanho máximo é de 16 caracteres).
  - `bankAgency` string, required: Número de agência (4 dígitos).
  - `bankAccount` string, required: Número de conta ao qual cartão será vinculado.
  - `programId` integer, required: Identificador do programa que será vinculado ao cartão.
  - `password` string, required: Senha do cartão para realizar transações (preencha com quatro números. Exemplo: '9348').
  - `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.

## Response `202`

A solicitação foi aceita e o cartão está sendo criado.

- 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)