---
updatedAt: 2026-06-03T13:12:46.000Z
agentTools:
  projectIndex: https://docs.bankly.com.br/llms.txt
---

# Emissão de cartão em lote

<div class="bkly-ref-description">
  <p>Crie um lote de cartões sem vínculo com uma conta (Cartão No Name).</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: card.create</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Criação de cartão em lote](/docs/criacao-de-cartoes-em-lote)."
}
[/block]


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0.0",
    "title": "Gestão de cartões",
    "description": "Solicite e gerencie cartões vinculados à conta do seu cliente em poucos\nminutos. Consulte também nossa\n[documentação](https://bankly.readme.io/v1.0/docs/) para mais detalhes sobre\nos fluxos de negócio.\n"
  },
  "servers": [
    {
      "url": "https://api-mtls.sandbox.bankly.com.br"
    }
  ],
  "paths": {
    "/cards/virtual": {
      "post": {
        "tags": [
          "Emissão de cartão"
        ],
        "summary": "Cartão virtual",
        "description": "<div class=\"bkly-ref-description\">\n  <p>Crie um cartão virtual que poderá ser utilizado em compras <i>on-line</i>.</p> \n  <span class=\"bkly-ref-small-stable-tag\">stable</span> \n  <span class=\"bkly-ref-scope-tag\">scope: card.create</span>\n</div>\n
[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Nota\",\n  \"body\": \"Para mais informações, confira a documentação [Emissão de cartão virtual](/docs/emissao-cartao-virtual).\"\n}\n[/block]
\n",
        "operationId": "cardCreateVirtualCard",
        "parameters": [
          {
            "$ref": "#/components/parameters/apiVersion"
          },
          {
            "$ref": "#/components/parameters/authorization"
          },
          {
            "name": "x-bkly-license",
            "in": "header",
            "description": "Identificador da licença bancária utilizada pelo parceiro.",
            "required": true,
            "style": "simple",
            "explode": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/createCardRequest"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "A solicitação foi aceita e o cartão está sendo criado.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/cardBuildingResponse"
                },
                "examples": {
                  "response": {
                    "value": {
                      "proxy": "2370021007715002820",
                      "activateCode": "A0DDDC0951D1"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/paths/~1cards~1limit/patch/responses/400"
          },
          "401": {
            "$ref": "#/paths/~1cards~1batches/get/responses/401"
          },
          "406": {
            "description": "A solicitação não foi aceita.",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1cards~1limit/patch/responses/400/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1cards~1limit/patch/responses/400/content/application~1json/schema"
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "SOME_ERROR_CODE",
                          "messages": [
                            "{{Some error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Solicitação recusada"
                  }
                }
              }
            }
          },
          "409": {
            "description": "A solicitação conflitou com o estado atual do recurso existente no servidor.\n",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1cards~1limit/patch/responses/400/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1cards~1limit/patch/responses/400/content/application~1json/schema"
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "SOME_ERROR_CODE",
                          "messages": [
                            "{{Some error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Conflito entre regras de negócio"
                  }
                }
              }
            }
          },
          "500": {
            "$ref": "#/paths/~1cards~1limit/patch/responses/500"
          }
        },
        "x-amazon-apigateway-auth": {
          "type": "NONE"
        },
        "x-amazon-apigateway-integration": {
          "uri": "http://lb-towner-a26f32e03d8f2933.elb.us-east-1.amazonaws.com:7011/api/cards/virtual",
          "passthroughBehavior": "when_no_match",
          "connectionType": "VPC_LINK",
          "connectionId": "m116y5",
          "httpMethod": "POST",
          "type": "http",
          "requestParameters": {
            "integration.request.header.api-version": "method.request.header.api-version",
            "integration.request.header.Authorization": "method.request.header.Authorization"
          },
          "responses": {
            "202": {
              "statusCode": 202
            },
            "400": {
              "statusCode": 400
            },
            "401": {
              "statusCode": 401
            },
            "406": {
              "statusCode": 406
            },
            "409": {
              "statusCode": 409
            },
            "500": {
              "statusCode": 500
            }
          }
        }
      }
    },
    "/cards/batches/": {
      "post": {
        "tags": [
          "Cartões No Name"
        ],
        "summary": "Emissão de cartão em lote",
        "description": "<div class=\"bkly-ref-description\">\n  <p>Crie um lote de cartões sem vínculo com uma conta (Cartão No Name).</p> \n  <span class=\"bkly-ref-small-stable-tag\">stable</span> \n  <span class=\"bkly-ref-scope-tag\">scope: card.create</span>\n</div>\n
[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Nota\",\n  \"body\": \"Para mais informações, confira a documentação [Criação de cartão em lote](/docs/criacao-de-cartoes-em-lote).\"\n}\n[/block]
\n",
        "operationId": "cardCreateCardsInLot",
        "parameters": [
          {
            "$ref": "#/components/parameters/apiVersion"
          },
          {
            "$ref": "#/components/parameters/authorization"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/createCardsInLotRequest"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "A solicitação foi aceita e o cartão em lote está sendo criado.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/createCardInLotResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/paths/~1cards~1limit/patch/responses/400"
          },
          "401": {
            "$ref": "#/paths/~1cards~1batches/get/responses/401"
          },
          "406": {
            "$ref": "#/paths/~1cards~1virtual/post/responses/406"
          },
          "409": {
            "$ref": "#/paths/~1cards~1virtual/post/responses/409"
          },
          "500": {
            "$ref": "#/paths/~1cards~1limit/patch/responses/500"
          }
        },
        "x-amazon-apigateway-auth": {
          "type": "NONE"
        },
        "x-amazon-apigateway-integration": {
          "uri": "http://lb-towner-a26f32e03d8f2933.elb.us-east-1.amazonaws.com:7011/api/lots/",
          "passthroughBehavior": "when_no_match",
          "connectionType": "VPC_LINK",
          "connectionId": "m116y5",
          "httpMethod": "POST",
          "type": "http",
          "requestParameters": {
            "integration.request.header.api-version": "method.request.header.api-version",
            "integration.request.header.Authorization": "method.request.header.Authorization"
          },
          "responses": {
            "202": {
              "statusCode": 202
            },
            "400": {
              "statusCode": 400
            },
            "401": {
              "statusCode": 401
            },
            "406": {
              "statusCode": 406
            },
            "409": {
              "statusCode": 409
            },
            "500": {
              "statusCode": 500
            }
          }
        }
      }
    },
    "/cards/batches": {
      "get": {
        "tags": [
          "Cartões No Name"
        ],
        "summary": "Consulta dos lotes",
        "description": "<div class=\"bkly-ref-description\">\n  <p>Obtenha os dados de todos os lotes de cartões. </p>  \n  <span class=\"bkly-ref-small-stable-tag\">stable</span> \n  <span class=\"bkly-ref-scope-tag\">scope: card.read</span>\n</div>\n
[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Nota\",\n  \"body\": \"Para mais informações, confira a documentação [Consulta dos lotes](/docs/consulta-de-lotes).\"\n}\n[/block]
\n",
        "operationId": "cardGetLotsByCompanyKey",
        "parameters": [
          {
            "$ref": "#/components/parameters/apiVersion"
          },
          {
            "$ref": "#/components/parameters/authorization"
          }
        ],
        "responses": {
          "200": {
            "description": "Solicitação recebida com sucesso.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/cardLotsResponse"
                },
                "examples": {
                  "response": {
                    "value": [
                      {
                        "lotId": "LT01",
                        "quantityOrder": 1000,
                        "companyKey": "Acesso",
                        "dateOrder": "2021-06-07T08:30:40",
                        "programId": 1
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/paths/~1cards~1limit/patch/responses/400"
          },
          "401": {
            "description": "Acesso não autorizado.\n",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1cards~1limit/patch/responses/400/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1cards~1limit/patch/responses/400/content/application~1json/schema"
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "SOME_ERROR_CODE",
                          "messages": [
                            "{{Some error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Acesso não autorizado"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Não foram encontrados lotes para essa company key."
          },
          "500": {
            "$ref": "#/paths/~1cards~1limit/patch/responses/500"
          }
        },
        "x-amazon-apigateway-auth": {
          "type": "NONE"
        },
        "x-amazon-apigateway-integration": {
          "uri": "http://lb-towner-a26f32e03d8f2933.elb.us-east-1.amazonaws.com:7011/api/lots/",
          "passthroughBehavior": "when_no_match",
          "connectionType": "VPC_LINK",
          "connectionId": "m116y5",
          "httpMethod": "GET",
          "type": "http",
          "requestParameters": {
            "integration.request.header.api-version": "method.request.header.api-version",
            "integration.request.header.Authorization": "method.request.header.Authorization"
          },
          "responses": {
            "200": {
              "statusCode": 200
            },
            "204": {
              "statusCode": 204
            },
            "400": {
              "statusCode": 400
            },
            "401": {
              "statusCode": 401
            },
            "500": {
              "statusCode": 500
            }
          }
        }
      }
    },
    "/cards/limit": {
      "patch": {
        "tags": [
          "Gestão de limite de crédito"
        ],
        "summary": "Alteração de limite ativo de cartão pós-pago",
        "description": "<div class=\"bkly-ref-description\">\n  <p>Altere o limite de crédito ativo de um cartão pós-pago.</p> \n  <span class=\"bkly-ref-small-stable-tag\">stable</span> \n  <span class=\"bkly-ref-scope-tag\">scope: card.update</span>\n</div>\n
[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Nota\",\n  \"body\": \"Para mais informações, confira a documentação [Alteração de limite ativo de cartão pós-pago](/docs/alteracao-limite-ativo-cartao).\"\n}\n[/block]
\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/apiVersion"
          },
          {
            "$ref": "#/components/parameters/authorization"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/limitAlterationRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Limite de crédito ativo alterado com sucesso."
          },
          "400": {
            "description": "Há algum problema com a sua requisição.",
            "headers": {
              "x-bkly-correlation-id": {
                "description": "Id correlação da operação requisitada.",
                "style": "simple",
                "explode": false,
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "description": "Detalhes do erro identificado.",
                  "type": "object",
                  "properties": {
                    "errors": {
                      "description": "Lista de erros identificados. Trate-os antes de tentar novamente.",
                      "type": "array",
                      "nullable": true,
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "description": "Código do erro.",
                            "type": "string",
                            "nullable": true
                          },
                          "propertyName": {
                            "description": "Parâmetro ou propriedade com problema. Somente será retornado quando o erro for de sintaxe (Bad Request).",
                            "type": "string",
                            "nullable": true
                          },
                          "message": {
                            "description": "Lista de descrições do problema encontrado.",
                            "type": "array",
                            "nullable": true,
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "reference": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "INVALID_PARAMETER",
                          "propertyName": "{{propertyName}}",
                          "messages": [
                            "{{\"propertyName\" error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Parametro inválido"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Recurso não encontrado.\n",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1cards~1limit/patch/responses/400/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1cards~1limit/patch/responses/400/content/application~1json/schema"
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "SOME_ERROR_CODE",
                          "messages": [
                            "{{Some error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Recurso não encontrado"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Ocorreu algum erro inexperado em nosso servidor.\n",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1cards~1limit/patch/responses/400/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1cards~1limit/patch/responses/400/content/application~1json/schema"
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "SOME_ERROR_CODE",
                          "messages": [
                            "{{Some error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Erro no servidor"
                  }
                }
              }
            }
          }
        },
        "x-amazon-apigateway-auth": {
          "type": "NONE"
        },
        "x-amazon-apigateway-integration": {
          "uri": "http://lb-towner-a26f32e03d8f2933.elb.us-east-1.amazonaws.com:7011/api/cards/{proxy}/password",
          "passthroughBehavior": "when_no_match",
          "connectionType": "VPC_LINK",
          "connectionId": "m116y5",
          "httpMethod": "PATCH",
          "type": "http",
          "requestParameters": {
            "integration.request.path.proxy": "method.request.path.proxy",
            "integration.request.header.authorization-token": "method.request.header.authorization-token",
            "integration.request.header.api-version": "method.request.header.api-version",
            "integration.request.header.Authorization": "method.request.header.Authorization"
          },
          "responses": {
            "200": {
              "statusCode": 200
            },
            "400": {
              "statusCode": 400
            },
            "401": {
              "statusCode": 401
            },
            "404": {
              "statusCode": 404
            },
            "409": {
              "statusCode": 409
            },
            "500": {
              "statusCode": 500
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    },
    "parameters": {
      "apiVersion": {
        "name": "api-version",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "description": "Versão da API. Atualmente estamos na versão 1.0."
        }
      },
      "authorization": {
        "name": "Authorization",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "description": "<em>Token</em> de autorização do tipo Bearer."
        }
      }
    },
    "schemas": {
      "addressRequest": {
        "type": "object",
        "description": "Objeto que deverá conter informações sobre o endereço do titular do cartão.",
        "required": [
          "zipCode",
          "address",
          "neighborhood",
          "number",
          "city",
          "state",
          "country"
        ],
        "properties": {
          "zipCode": {
            "type": "string",
            "description": "Código postal de endereço. Informe somente números. O CEP deve ser nacional.",
            "maxLength": 8
          },
          "address": {
            "type": "string",
            "description": "Logradouro (nome da rua, avenida etc.).",
            "maxLength": 256
          },
          "number": {
            "type": "string",
            "description": "Número do imóvel."
          },
          "complement": {
            "type": "string",
            "description": "Complemento do endereço."
          },
          "neighborhood": {
            "type": "string",
            "description": "Nome do bairro.",
            "maxLength": 256
          },
          "city": {
            "type": "string",
            "description": "Nome da cidade.",
            "maxLength": 256
          },
          "state": {
            "type": "string",
            "description": "Nome do estado. Formato ISO 3166-2:BR."
          },
          "country": {
            "type": "string",
            "description": "Nome do país. Formato ISO 3166-2:BR."
          }
        }
      },
      "createCardInLotResponse": {
        "type": "object",
        "properties": {
          "lotId": {
            "type": "string",
            "description": "Identificador único do lote."
          }
        }
      },
      "createCardsInLotRequest": {
        "type": "object",
        "properties": {
          "programId": {
            "type": "integer",
            "description": "Identificador do programa que será vinculado ao cartão."
          },
          "quantityCards": {
            "type": "integer",
            "description": "Quantidade de cartões em lote (informar um valor acima de 0 e menor que 2000)."
          },
          "paymentDay": {
            "type": "integer",
            "description": "Dia de pagamento do cartão."
          },
          "address": {
            "$ref": "#/components/schemas/addressRequest"
          }
        },
        "required": [
          "programId",
          "quantityCards",
          "address"
        ]
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true,
    "samples-languages": [
      "curl"
    ]
  }
}
```