Java

sudo apt install maven

choco install maven -y

git clone https://github.com/anthonymengottii/alpa-java-sdk
cd alpa-java-sdk && mvn install -DskipTests

<dependency>
    <groupId>com.alpa</groupId>
    <artifactId>alpa-java</artifactId>
    <version>2.0.0</version>
</dependency>

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.17.1</version>
</dependency>

import com.alpa.AlpaClient;

// Inicialize o SDK com sua API Key
AlpaClient alpa = new AlpaClient(System.getenv("ALPA_API_KEY"));

import com.alpa.AlpaClient;
import com.fasterxml.jackson.databind.JsonNode;
import java.util.Map;

AlpaClient alpa = new AlpaClient(System.getenv("ALPA_API_KEY"));

JsonNode link = alpa.paymentLinks.create(Map.of(
    "title",       "Produto Premium",
    "amountCents", 9900,
    "description", "Acesso vitalício"
));

// A resposta traz o slug; monte a URL do checkout a partir dele:
String slug = link.path("slug").asText();
System.out.println("https://checkout.usealpa.com/pay/" + slug);

{
  "id": "lnk_abc123",
  "title": "Produto Premium",
  "description": "Acesso vitalício",
  "amount": 9900,
  "currency": "BRL",
  "status": "ACTIVE",
  "slug": "abc123",
  "createdAt": "2026-04-08T00:00:00.000Z",
  "updatedAt": "2026-04-08T00:00:00.000Z"
}

JsonNode tx = alpa.transactions.create(Map.of(
    "product",        "Curso Java",
    "paymentMethod",  "PIX",
    "amountCents",    19900,
    "clientName",     "João Silva",
    "clientEmail",    "joao@example.com",
    "clientDocument", "12345678900"
));

System.out.println(tx.path("pixCopiaECola").asText());

JsonNode result = alpa.coupons.validate("DESCONTO10", 19900);

if (result.path("valid").asBoolean()) {
    System.out.println("Desconto: " + result.path("discountCents").asInt());
    System.out.println("Total: " + result.path("finalAmountCents").asInt());
}

// Spring Boot
@PostMapping("/webhook")
public ResponseEntity<?> webhook(
        @RequestBody byte[] body,
        @RequestHeader("x-webhook-signature") String signature
) throws Exception {
    if (!alpa.verifyWebhookSignature(new String(body), signature, System.getenv("ALPA_WEBHOOK_SECRET"))) {
        return ResponseEntity.status(401).body(Map.of("error", "Assinatura inválida"));
    }
    return ResponseEntity.ok(Map.of("received", true));
}

import com.alpa.utils.AlpaException;

try {
    JsonNode tx = alpa.transactions.create(Map.of(...));
} catch (AlpaException e) {
    System.err.println("Erro " + e.getStatusCode() + ": " + e.getMessage());
} catch (IOException | InterruptedException e) {
    System.err.println("Erro de rede: " + e.getMessage());
}