Appearance

PHP SDK ​

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

USDC on Base · secrets server-only.

bash
composer require autlantic/billing

Packagist: autlantic/billing 0.1.0. Mirror: Autlantic/billing-php. Source of truth remains sdks/php in payments-sdk.

VCS fallback (if you cannot use Packagist):

bash
composer config repositories.autlantic vcs https://github.com/Autlantic/billing-php.git
composer require autlantic/billing:^0.1

Or a path repo to payments-sdk/sdks/php.

Quick start ​

php
use Autlantic\Billing\AutlanticBilling;
use Autlantic\Billing\Webhook;

$billing = AutlanticBilling::fromEnv(); // AUTLANTIC_BILLING_API_KEY

$link = $billing->createPaymentLink([
  'amountUsdc' => 42,
  'merchantRefPrefix' => 'invoice',
  'successUrl' => 'myapp://billing/success',
  'cancelUrl' => 'myapp://billing/cancel',
]);
// Share $link['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 ​

php
$ok = Webhook::verify($secret, $rawBody, $signatureHeader);
$event = Webhook::parseEvent($rawBody);

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

Errors ​

AutlanticBillingException exposes codeName, statusCode, requestId, and body.

Sample merchant backend: examples/mobile-checkout/php (port 3058).