Emissão de cartão

Cartão virtual

<div class="bkly-ref-description"> <p>Crie um cartão virtual que poderá ser utilizado em compras <i>on-line</i>.</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 [Emissão de cartão virtual](/docs/emissao-cartao-virtual)." } [/block]
post/cards/virtual

Request

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

Headers

api-versionstring required

Versão da API. Atualmente estamos na versão 1.0.

Authorizationstring required

<em>Token</em> de autorização do tipo Bearer.

x-bkly-licensestring required

Identificador da licença bancária utilizada pelo parceiro.

Request body

documentNumberstring required

Número de documento de CPF ou CNPJ (informe somente números). Tamanho máximo de 14 caracteres.

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

aliasstring required

Apelido do cartão (não será permitido o uso de caracteres especiais e o tamanho máximo é de 16 caracteres).

bankAgencystring required

Número de agência (4 dígitos).

bankAccountstring required

Número de conta ao qual cartão será vinculado.

programIdinteger required

Identificador do programa que será vinculado ao cartão.

passwordstring required

Senha do cartão para realizar transações (preencha com quatro dígitos. Exemplo: '9348'). <b>Importante</b>: dependendo da configuração do programa, o envio deste campo poderá ser opcional. Neste caso, a senha será gerada randomicamente. Para que o parceiro possa utilizar a opção de senha randômica, é necessário que seja feita uma avaliação pelo time de segurança do Bankly e que o usuário tenha acesso à senha, seja pelo kit enviado, seja pelo <i>endpoint</i> de consulta de senhas.

metadataobject

Objeto que deverá conter informações adicionais pertinentes ao contexto, representadas por meio de pares de chave e valor.

Response

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

proxystring

Código identificador do cartão.

activateCodestring

Código para ativar o cartão.

Changes

No recorded changes to this operation across all 1 revision of this API.