> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Começando em SDK de Tokenização

> Com o SDK de Tokenização da Malga, simplifique sua integração e aumente a segurança ao tokenizar cartões no client-side.

<Warning>
  Esta versão do SDK foi depreciada e será removida em breve. Atualize sua
  integração para a [versão 2.0](/sdks/tokenization/v2/intro).
</Warning>

O SDK para potencializar sua integração: uma ferramenta que não só simplifica,
mas também fortalece a segurança ao tokenizar cartões no client-side.

### Configuração

Configurar o SDK de Tokenização é simples: basta possuir as credenciais da Malga, que consistem na `API Key` e no `Client ID`.
Se ainda não tem uma conta na Malga, é só [clicar aqui](https://dashboard.malga.io/sign-up) para criar uma conta em nosso Dashboard
e obter as credenciais necessárias para iniciar a integração.

Agora que você possui as chaves de acesso, basta baixar o pacote para o seu projeto, importá-lo e utilizar o seguinte código:

```typescript theme={null}
import { MalgaTokenization } from "@malga/tokenization";

const malgaTokenization = new MalgaTokenization({
  apiKey: "17a64c8f-a387-4682-bdd8-d280493715e0",
  clientId: "d1d2b51a-0446-432a-b055-034518c2660e",
  options: {
    sandbox: true,
    elements: {
      form: "data-malga-tokenization-form",
      holderName: "data-malga-tokenization-holder-name",
      cvv: "data-malga-tokenization-cvv",
      expirationDate: "data-malga-tokenization-expiration-date",
      number: "data-malga-tokenization-number",
    },
  },
});
```

Abaixo está a lista detalhada com todos os parâmetros de configuração disponíveis.

<Accordion title="Parâmetros de Configuração">
  <ParamField path="apiKey" required type="uuid">
    Chave de acesso a API
  </ParamField>

  <ParamField path="clientId" required type="uuid">
    Identificador único da sua conta na Malga
  </ParamField>

  <ParamField path="options" type="object">
    Configurações Adicionais

    <Accordion title="Parâmetros de Configuração">
      <ParamField path="form" type="string" default="data-malga-tokenization-form">
        Identificador da tag form <br />
      </ParamField>

      <ParamField path="holderName" type="string" default="data-malga-tokenization-holder-name">
        Identificador do campo de portador do cartão <br />
      </ParamField>

      <ParamField path="cvv" type="string" default="data-malga-tokenization-cvv">
        Identificador do campo de CVV

        <br />
      </ParamField>

      <ParamField path="expirationDate" type="string" default="data-malga-tokenization-expiration-date">
        Identificador do campo de data de expiração

        <br />
      </ParamField>

      <ParamField path="number" type="string" default="data-malga-tokenization-number">
        Identificador do campo de número do cartão

        <br />
      </ParamField>
    </Accordion>
  </ParamField>
</Accordion>

### Quickstart

Aprenda como configurar o Tokenization SDK e defina o que se encaixa melhor com o
seu projeto.

<CardGroup>
  <Card href="/sdks/tokenization/v1/quickstart" title="Quickstart">
    A forma mais simples de tokenizar cartões
  </Card>
</CardGroup>

### Exemplos

Confira os exemplos de projetos integrados com a Malga:

<CardGroup>
  <Card href="https://github.com/plughacker/malga-tokenization/tree/main/examples/v1/sync-tokenization" icon="https://mintlify.s3.us-west-1.amazonaws.com/malga/img/api-sdks/new-tab.svg" title="Sync Tokenization">
    Veja o código completo
  </Card>

  <Card href="https://github.com/plughacker/malga-tokenization/tree/main/examples/v1/form-handling-tokenization" icon="https://mintlify.s3.us-west-1.amazonaws.com/malga/img/api-sdks/new-tab.svg" title="Form Handling Tokenization">
    Veja o código completo
  </Card>
</CardGroup>