autlantic / module-billing

1.1.0 2026-09-29 18:37 UTC

Requires

• php: >=8.1
• autlantic/billing: ^0.1
• magento/framework: *
• magento/module-checkout: *
• magento/module-payment: *
• magento/module-sales: *

MIT

• Autlantic Limited

Published on Packagist.org on 2026-09-29 22:28 UTC

README

Autlantic Billing for Magento 2

USDC payments on Base
Official Magento payment method: single-use payment links, hosted checkout, signed webhooks, and invoice refunds.

Part of Autlantic Payments SDK. Composer package autlantic/module-billing 1.1.0 · Magento module Autlantic_Magento. Uses autlantic/billing.

USDC settles to your merchant payout wallet. Autlantic does not custody checkout funds.

Why this module

Same hosted Billing API as WooCommerce and the PHP SDK. Create a payment link, redirect the buyer to hosted checkout, verify x-autlantic-signature, invoice the Magento order. Secrets stay in Magento admin (encrypted), scoped per website.

Install

Production (VCS mirror)

# Magento root
composer config repositories.autlantic-magento vcs https://github.com/Autlantic/magento-autlantic.git
composer require autlantic/module-billing:^1.1
bin/magento module:enable Autlantic_Magento
bin/magento setup:upgrade
bin/magento cache:flush

Also require autlantic/billing (Packagist or billing-php).

Monorepo / development

composer config repositories.autlantic-php path /path/to/payments-sdk/sdks/php
composer config repositories.autlantic-magento path /path/to/payments-sdk/integrations/magento
composer require autlantic/module-billing:@dev
bin/magento module:enable Autlantic_Magento
bin/magento setup:upgrade
bin/magento cache:flush

Requires Magento Open Source / Adobe Commerce 2.4.6+, PHP 8.1+ (ext-curl, ext-json, ext-hash). Store currency USD or USDC.

Quick start

1. Stores → Configuration → Sales → Payment Methods → Autlantic Billing
2. Enable; paste API key (abk_test_… / abk_live_…) and webhook signing secret
3. Use Test connection, then register the shown webhook URL in the Autlantic portal
4. Place a test order with Autlantic → pay on hosted checkout → order invoices on payment.paid

What it does

Feature	Behavior
One-time checkout	POST /v1/payment-links (maxUses: 1), redirect via autlantic/payment/redirect
Webhooks	POST /autlantic/webhook with HMAC verify across website secrets
Refunds	Magento credit memo → Autlantic refundInvoice when an invoice id is on the order
Admin tools	Test connection, recent webhook activity, order Autlantic panel
Subscriptions	Not included in this module

Webhooks

Verify x-autlantic-signature with the portal endpoint secret that matches the API key mode (Test or Live). Multi-website installs try each configured website secret. Event ids are idempotent.

Handled events: payment.paid, invoice.paid, invoice.payment_failed, invoice.refunded.

Documentation

Commerce plugins	Woo / Magento / Shopify
Languages	All SDK surfaces
Webhooks	Signature & events
PHP SDK	autlantic/billing
Terms · Privacy · Security	Legal

Develop

php integrations/magento/bin/smoke.php

On tag integrations/magento/v*, .github/workflows/sync-magento-mirror.yml syncs magento-autlantic.

Changelog

1.1.0

• Fix checkout success redirect race (redirectAfterPlaceOrder: false)
• Website-scoped webhook signature verification
• Indexed Autlantic id → order lookup
• Admin test connection, webhook activity, order panel
• Invoice refunds + invoice.refunded / invoice.payment_failed

1.0.0

• Initial one-time checkout + signed webhooks

License

MIT · Operated by Autlantic Limited (UK company no. 17422039).

Part of Autlantic Payments SDK.