Laravel API Integration Integration

1📦 Installation via Composer

composer require payerurl/binance-and-crypto-checkout

2⚙️ Publish Configuration

php artisan vendor:publish \
  --provider="Payerurl\Providers\AppServiceProvider" \
  --tag=config

3🔑 Get Your API Key (Free)

• Sign up at dash.payerurl.com
• Go to Dashboard → Get API Credentials
• Copy your Public Key and Secret Key

👉 Registration is free and takes under 2 minutes. No credit card required.

4🔑 Environment Configuration

Add your API credentials to .env:

PAYERURL_PUBLIC_KEY="your_public_key"
PAYERURL_SECRET_KEY="your_secret_key"

5🚀 Quick Start — Controller Integration

use Payerurl\Payerurl;

public function pay()
{
    $invoiceId = 'LRB-' . time();
    $amount    = 1000; // $1000.00
    $currency  = 'usd';

    $data = [
        'first_name'   => 'Alice',
        'last_name'    => 'Smith',
        'email'        => '[email protected]',
        'redirect_url' => route('payment.success'),
        'cancel_url'   => route('cart'),
    ];

    $response = Payerurl::payment($invoiceId, $amount, $currency, $data);

    if ($response['status']) {
        return redirect()->away($response['redirectUrl']);
    }

    return back()->with('error', $response['message']);
}

6🔔 Webhook — Payment Notify

The package auto-registers POST /{APP_URL}/payerurl/notify. Listen for the event in your EventServiceProvider:

use Payerurl\Events\PaymentNotifySuccess;

protected $listen = [
    PaymentNotifySuccess::class => [
        \App\Listeners\UpdateOrderOnPayerurlPayment::class,
    ],
];

// In your Listener:
public function handle(PaymentNotifySuccess $event): void
{
    $orderId = $event->payload['order_id'];
    // Update your order status here
}

Do I need a Binance merchant account?

No. The package works with a standard personal Binance account. You can start accepting Binance QR code payments immediately without any business verification.

Is there a transaction fee?

No network or hidden fees from PayerURL. Standard blockchain network fees may apply depending on the coin and network chosen by the customer.

Can I use this without KYC?

Yes. Basic accounts can receive and process crypto payments without mandatory identity verification.

Does this work with Laravel API / REST endpoints?

Yes — it's a standard Laravel package that integrates with any controller, API resource, or Livewire component.

How do I handle the webhook in Laravel?

The package auto-registers the webhook route. Listen for the PaymentNotifySuccess event in your EventServiceProvider — no manual route setup needed.