Criação de cartões em lote

A criação de cartões em lote permite solicitar uma quantidade elevada de cartões físicos No Name (100, 500, 1 mil etc.) em uma única requisição.

Isso possibilita ao parceiro estocar os cartões emitidos e, posteriormente, enviá-los a seus clientes para ativação.

Para realizar a emissão em lote, os cartões não precisam estar relacionados a nenhuma conta, somente ao endereço de entrega.

🚧

Importante

Embora o cartão No Name não requeira os dados do cliente no momento de sua criação, ele precisará ser vinculado a um documento e a uma conta para ser ativado.

Etapas

Endpoint

Para utilizar este endpoint, preencha os seguintes campos obrigatórios:

• programId: identificador do programa que será vinculado ao cartão. Caso esse campo não seja informado, o sistema utilizará o programa padrão para o tipo de cartão que está sendo solicitado;
• quantityCards: quantidade de cartões a serem emitidos nesse lote (informe um valor superior a 0 e inferior a 2000);
• address: objeto que contém informações sobre o endereço de entrega:
  • zipCode: CEP (informe somente os números);
  • address: logradouro;
  • number: número do local;
  • neighborhood: bairro;
  • city: cidade;
  • country: país.

Opcionalmente, informe os campos:

• complement: complemento do endereço (subcampo do objeto address);
• paymentDay: dia de pagamento do cartão. O valor desse campo deve ser superior a 1 e igual ou inferior a 28. Caso o campo não seja informado, o sistema assumirá como valor 1.

curl --location --request POST 
--url 'https://api-mtls.sandbox.bankly.com.br/cards/batches/' \  
--header 'api-version: 1' \  
--header 'Authorization: Bearer {{accessToken}}' \  
--header 'Content-Type: application/json' \  
--data-raw '  
    {
        "programId": 111,
        "quantityCards": 100,
        "paymentDay": 1,
        "address": {
            "zipCode": "05402100",
            "address": "Av Rebouças",
            "number": "1368",
            "neighborhood": "Pinheiros",
            "complement": "3o Andar",
            "city": "São Paulo",
            "state": "SP",
            "country": "BR"
        }
    }

Retorno

O status code 202 indicará sucesso na requisição. O retorno trará o lotId (identificador do lote criado).

Erros