---
title: "Geração de token"
method: POST
path: "/cards-pci/{proxy}/wallet/{wallet}/brand/{brand}"
tags: ["Carteiras digitais"]
---

# Geração de token

`POST /cards-pci/{proxy}/wallet/{wallet}/brand/{brand}`

## Request

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

<div class="bkly-ref-description">
  <p>Gere um <i>token</i> com os dados criptografados do cartão para adicioná-lo a uma carteira digital (Google Pay ou Apple Pay).</p>
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: card.pci.token.create</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Geração de <em>token</em>](/docs/geracao-de-token)."
}
[/block]

## Path parameters

- `proxy` string, required: Código identificador do cartão.
- `wallet` 'GooglePay' | 'ApplePay', required: Carteira digital à qual o cartão deverá ser adicionado.
- `brand` 'Mastercard', required: Bandeira do cartão.

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

- GenerateTokenRequest
  - `nonce` string: Valor, em formato hexadecimal, gerado no dispositivo que associa uma sessão de cliente a um token ID da Apple, obtido via SDK da Apple. **Importante**: este campo <b>somente</b> deverá ser enviado em caso de adição à <i>wallet</i> da ApplePay.
  - `nonceSignature` string: Assinatura, em formato hexadecimal, gerada no dispositivo que associa uma sessão de cliente a um token ID da Apple, obtido via SDK da Apple. **Importante**: este campo <b>somente</b> deverá ser enviado em caso de adição à <i>wallet</i> da ApplePay.
  - `appleCertificate` string: Listas de certificados do dispositivo, em formato PEM, obtidos via SDK da Apple. **Importante**: este campo <b>somente</b> deverá ser enviado em caso de adição à <i>wallet</i> da ApplePay.

## Response `200`

O <em>token</em> foi gerado com sucesso.

- CardTokenizationResponse
  - `data` string: <em>Token</em> gerado em formato base64, que deverá ser enviado ao SDK da carteira digital correspondente. <b>Importante</b>: para a tokenização na Apple Pay, ao decodificar o <em>token</em>, será obtido um JSON com os campos <code>EphemeralPublicKey</code>, <code>EncryptedData</code>, <code>ActivationData</code>.
  - `lastFourDigits` string: Últimos quatro dígitos do cartão.
  - `phoneNumber` string: Número de contato do cliente.
  - `address` AddressResponse: Objeto que contém informações sobre o endereço do cliente.
    - `zipCode` string: Código postal de endereço.
    - `address` string: Logradouro (nome da rua, avenida etc.).
    - `number` string: Número do imóvel.
    - `complement` string: Complemento do endereço.
    - `neighborhood` string: Nome do bairro.
    - `city` string: Nome da cidade.
    - `state` string: Nome do estado. Formato ISO 3166-2:BR.
    - `country` string: Nome do país. Formato ISO 3166-2:BR.

## Other responses

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