Appearance

Java SDK ​

Official Autlantic Billing server client for Java. Part of the Autlantic Payments SDK · Languages.

USDC on Base · secrets server-only.

Source: sdks/java. Package: com.autlantic:billing 0.1.1 on Maven Central.

Install ​

kotlin
dependencies {
  implementation("com.autlantic:billing:0.1.1")
}
xml
<dependency>
  <groupId>com.autlantic</groupId>
  <artifactId>billing</artifactId>
  <version>0.1.1</version>
</dependency>

Quick start ​

java
import com.autlantic.billing.AutlanticBilling;
import com.autlantic.billing.Webhook;
import java.util.Map;

AutlanticBilling billing = AutlanticBilling.fromEnv(); // AUTLANTIC_BILLING_API_KEY

Map<String, Object> link = billing.createPaymentLink(Map.of(
  "amountUsdc", 42,
  "merchantRefPrefix", "invoice",
  "successUrl", "myapp://billing/success",
  "cancelUrl", "myapp://billing/cancel"
));
// Share link.get("url") or open it with the mobile Checkout SDK

Environment ​

Env varPurpose
AUTLANTIC_BILLING_API_KEYabk_test_… or abk_live_… (required)
AUTLANTIC_BILLING_API_URLDefault https://billing.autlantic.com
AUTLANTIC_BILLING_MERCHANT_IDOptional merchant id

Hosted mode only. Pins Autlantic-Version: 2026-01-01. Idempotent POSTs and retries on 429/5xx.

Client methods ​

MethodDescription
listProducts()Catalog
createSubscription(body)Incomplete subscription + checkout URL
getSubscription(id)Fetch
activateSubscription(id)Activate
cancelSubscription(id, body)Cancel
createPayment(body)One-time payment
getPayment(id)Fetch
createPaymentLink(body)Shareable link
listPaymentLinks()List
getPaymentLink(id)Fetch
disablePaymentLink(id)Disable
listInvoices(subscriptionId)List invoices

Webhooks ​

java
boolean ok = Webhook.verify(secret, rawBody, signatureHeader);
Map<String, Object> event = Webhook.parseEvent(rawBody);

Also: Webhook.verifyDetailed, Webhook.signBody (tests). Header: x-autlantic-signature. See Webhooks.

Errors ​

AutlanticBillingException exposes code, statusCode, requestId, and body.

Sample merchant backend: examples/mobile-checkout/java (port 3059).