oxialink/oxialink-laravel

Laravel package for the Oxialink crypto payment gateway: config, facade, auto-registered webhook route firing Laravel events.

v1.0.0 2026-08-20 04:11 UTC

Requires

• php: >=8.0
• illuminate/support: ^9.0|^10.0|^11.0|^12.0
• oxialink/oxialink-php: ^1.0

MIT

• payment
• gateway
• crypto
• laravel
• bitcoin
• USDT
• oxialink

Published on Packagist.org on 2026-08-20 04:13 UTC

README

Accept crypto payments in Laravel with the Oxialink gateway: a configured client, a facade, and a webhook route that verifies signatures and fires a Laravel event.

Install

composer require oxialink/oxialink-laravel
php artisan vendor:publish --tag=oxialink-config

.env:

OXIALINK_API_KEY=ak_...
OXIALINK_API_SECRET=as_...
OXIALINK_WEBHOOK_SECRET=whsec_...

Create an invoice

use Oxialink\Laravel\Facades\Oxialink;

$invoice = Oxialink::createInvoice([
    'amount' => 25,
    'fiat_currency' => 'USD',
    'coin' => 'USDT_TON',
    'external_id' => (string) $order->id,
    'callback_url' => route('oxialink.webhook'),
    'redirect_url' => route('orders.show', $order),
]);

return redirect()->away($invoice['url']);

Handle payments

The package registers POST /oxialink/webhook (configurable) and fires Oxialink\Laravel\Events\OxialinkWebhook for every verified delivery:

use Oxialink\Laravel\Events\OxialinkWebhook;

Event::listen(function (OxialinkWebhook $webhook) {
    if ($webhook->event === 'payment.completed') {
        Order::find($webhook->data['external_id'])?->markPaid($webhook->data['tx_hash']);
    }
});

Signatures are HMAC-SHA256 verified byte-exactly before the event fires; invalid deliveries never reach your code.

Full API reference: https://oxialink.com/api-docs