open-index/open-npm huggingface dataset:
npm package: @pandapayoficial/sdk
Description: PandaPay SDK
Author: pqpcara
Latest version: 0.0.2

# 🐼 PandaPay SDK

Aceite pagamentos via **Pix** de forma rápida, segura e sem complicações.  
Com a PandaPay, você gera QR Codes, consulta pagamentos, acessa saldo e automatiza todo o fluxo financeiro da sua plataforma.

---

## Recursos Principais

- **Geração de Pix (QR Code e Copia & Cola)**
- **Consulta de Pagamento**
- **Consulta de Saldo**

---

## Instalação

```bash
npm install @pandapayoficial/sdk
```

ou

```bash
yarn add @pandapayoficial/sdk
```

---

## Como Usar

### **Importação**

```js
const PandaPayClient = require("@pandapayoficial/sdk");

const PandaPay = new PandaPayClient("YOUR_API_KEY");
```
or
```ts
import PandaPayClient from "@pandapayoficial/sdk";

const PandaPay = new PandaPayClient("YOUR_API_KEY");
```

---

# Exemplos

---

## Consultar Saldo

```ts
const balance = await PandaPay.getBalance();

if (balance.success !== false) {
  console.log(balance.data.available);
}

console.log(balance.data);
```

---

## Gerar uma Chave Pix

```ts
const pixKey = await PandaPay.generatePixKey({
  amount: 5,
  productName: "Product Name",
  productDescription: "Product Description",
  customerName: "Customer Name",
  customerEmail: "customeremail@exemple.com",
  customerDocument: "00000000000",
  expiresIn: 3600,
});

console.log(pixKey);
```

---

## Consultar Status de Pagamento

```ts
if (pixKey.success !== false) {
  const pixStatus = await PandaPay.getPayment(pixKey.data.id);

  console.log(pixStatus.data);
}
```

---

# Documentação Oficial

Acesse a documentação completa da API PandaPay para detalhes sobre endpoints, autenticação e integrações avançadas.

---

# Como Começar

### **1. Obtenha sua API Key**
Acesse o painel em **API & Credenciais**.

### **2. URL Base**
```
https://pandapay.com.br/api_pp
```

### **3. Teste sua Conexão**
Realize uma requisição simples como consultar saldo.

---

# Dicas Rápidas

- Substitua `YOUR_API_KEY` pela sua chave real.
- Valores são sempre em **centavos**.
- QR Codes expiram em **30 minutos**.
- Use **webhooks** para notificações instantâneas.

---