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

# Introdução

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 CVV<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="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/sync-tokenization" icon="https://mintlify.s3.us-west-1.amazonaws.com/malga-develop/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/form-handling-tokenization" icon="https://mintlify.s3.us-west-1.amazonaws.com/malga-develop/img/api-sdks/new-tab.svg" title="Form Handling Tokenization">
    Veja o código completo
  </Card>
</CardGroup>