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

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

# Node.js

> Quickstart da API SDK Malga em Node.js: instalação, autenticação e primeiros passos para integrar pagamentos no seu backend JavaScript.

Aprenda como fazer sua primeira transação usando o Malga Node.js SDK.

### Pré-requisitos

Para que você consiga aproveitar ao máximo esse guia, será necessário ter chaves de integração de sandbox. Basta [clicar aqui](https://dashboard.malga.io/sign-up) e criar uma conta em nosso Dashboard.

### 1. Instalando o SDK

Instale nosso SDK com o seu gerenciador de pacotes favorito.

> [tab] npm
>
> ```bash theme={null}
> npm install malga
> ```

> [tab] yarn
>
> ```bash theme={null}
> yarn add malga
> ```

> [tab] pnpm
>
> ```bash theme={null}
> pnpm add malga
> ```

### 2. Fazendo sua primeira cobrança

Crie uma cobrança de forma simplificada.

> [tab] server
>
> ```typescript theme={null}
> import { Malga } from "malga";
>
> const malga = new Malga({
>   apiKey: "8468a624-68c1-49a3-b9f1-a22455053a38",
>   clientId: "ebb9c69c-4ad6-49fd-a565-a35cb4c967b3",
>   options: { sandbox: true },
> })(async function () {
>   try {
>     const data = await malga.charges.create({
>       merchantId: "2ed73b94-175a-438d-ae73-d11902492b75",
>       amount: 100,
>       paymentMethod: {
>         type: "credit",
>         installments: 1,
>         card: {
>           holderName: "João da Silva",
>           number: "5453881028277600",
>           cvv: "170",
>           expirationDate: "10/2030",
>         },
>       },
>     });
>
>     console.log(data);
>   } catch (error) {
>     console.error(error);
>   }
> })();
> ```

### 3. Teste você mesmo

> [card] [Exemplo Node.js](https://github.com/plughacker/malga-node/tree/main/examples/nodejs)
>
> Veja o código completo


## Related topics

- [Webhooks v1.1: notificações de eventos da Malga](https://docs.malga.io/documentations/webhooks/webhook1-1.md)
- [Criar chave pública](https://docs.malga.io/sdks/api-sdks/docs/auth/create-public-key.md)
- [Criar cartão](https://docs.malga.io/sdks/api-sdks/docs/cards/create-card.md)
- [Buscar cartão](https://docs.malga.io/sdks/api-sdks/docs/cards/find-card.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.