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

# Java

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

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

## Pré-requisitos

* Java 8+ e Maven
* Uma chave de API ([criar no dashboard](https://app.abacatepay.com))

## Instalação

Adicione a dependência Feign ao seu `pom.xml`:

```xml theme={null}
<dependency>
    <groupId>io.github.openfeign</groupId>
    <artifactId>feign-core</artifactId>
    <version>11.7</version>
</dependency>
```

## Configuração

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

```java theme={null}
import com.abacatepay.AbacatePay;

AbacatePay abacate = new AbacatePay(System.getenv("ABACATEPAY_API_KEY"));
```

## Primeira cobrança

```java theme={null}
import com.abacatepay.model.billing.CreateBillingData;
import com.abacatepay.model.billing.CreateBillingResponse;
import java.util.Arrays;

CreateBillingData billingData = new CreateBillingData();
billingData.setFrequency("ONE_TIME");
billingData.setMethods(Arrays.asList("PIX"));
billingData.setReturnUrl("https://meusite.com/app");
billingData.setCompletionUrl("https://meusite.com/pagamento/sucesso");

CreateBillingResponse billing = abacate.createBilling(billingData);
System.out.println(billing.getUrl()); // URL de pagamento para o cliente
```

**Resposta:**

```json theme={null}
{
  "success": true,
  "error": null,
  "data": {
    "id": "bill_12345667",
    "url": "https://app.abacatepay.com/pay/bill_12345667",
    "amount": 1000,
    "status": "PENDING",
    "devMode": true,
    "createdAt": "2024-11-04T18:38:28.573Z"
  }
}
```

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