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

# Go

> Integre a AbacatePay em aplicações Go em minutos.

<Card title="AbacatePay Go SDK" icon="github" href="https://github.com/AbacatePay/abacatepay-go-sdk">
  Repositório oficial — issues, changelog e contribuições.
</Card>

## Pré-requisitos

* Go 1.21+
* Uma chave de API ([criar no dashboard](https://app.abacatepay.com))

## Instalação

```bash theme={null}
go get github.com/AbacatePay/abacatepay-go-sdk
```

## Configuração

Armazene sua chave de API em uma variável de ambiente e nunca no código:

```go theme={null}
import (
    "os"
    "time"
    "github.com/AbacatePay/abacatepay-go-sdk/abacatepay"
)

client, err := abacatepay.New(&abacatepay.ClientConfig{
    ApiKey:  os.Getenv("ABACATEPAY_API_KEY"),
    Timeout: 10 * time.Second,
})
if err != nil {
    panic(err)
}
```

## Primeira cobrança (PIX)

```go theme={null}
import (
    "context"
    "log"
    "time"

    "github.com/AbacatePay/abacatepay-go-sdk/v1/pix"
)

ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
defer cancel()

response, err := client.Pix.Create(ctx, &pix.CreateQrCodePIXBody{
    Amount: 1000, // em centavos
})
if err != nil {
    log.Fatal(err)
}

log.Printf("PIX criado: %s\n", response.Data.ID)
```

**Resposta:**

```json theme={null}
{
  "success": true,
  "error": null,
  "data": {
    "id": "pix_char_123456",
    "amount": 1000,
    "status": "PENDING",
    "devMode": true,
    "brCode": "00020101021226950014br.gov.bcb.pix...",
    "createdAt": "2025-03-24T21:50:20.772Z",
    "expiresAt": "2025-03-25T21:50:20.772Z"
  }
}
```

## Próximos passos

<CardGroup cols={2}>
  <Card title="Configurar webhooks" icon="bell" href="/pages/webhooks">
    Receba notificações em tempo real sobre pagamentos confirmados.
  </Card>

  <Card title="Checkout Transparente" icon="credit-card" href="/pages/transparents/create">
    Aceite PIX e cartão diretamente na sua interface.
  </Card>

  <Card title="Criar clientes" icon="users" href="/pages/client/create">
    Gerencie clientes vinculados às cobranças.
  </Card>

  <Card title="Referência completa" icon="book-open" href="/pages/reference/introduction">
    Todos os endpoints, status codes e formato de resposta.
  </Card>
</CardGroup>
