README

🪙 Binance & Crypto Payment Gateway for Laravel

Accept Bitcoin, USDT, USDC, ETH, and Binance payments directly into your wallet — no middleman, no merchant account, no KYC required.

Powered by PayerURL — the direct-to-wallet crypto payment processor for Laravel developers.

🔴 LIVE DEMO | 🔑 Get API Key | 💬 Telegram Support

✅ Why Developers Choose This Package

📦 Installation

composer require payerurl/binance-and-crypto-checkout

⚙️ Publish Configuration

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

🔑 Get Your API Key (Free)

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

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

🔑 Environment Configuration

Add your API credentials to .env:

PAYERURL_PUBLIC_KEY="your_public_key"
PAYERURL_SECRET_KEY="your_secret_key"

Get your API keys from: https://dash.payerurl.com/profile/get-api-credentials

🚀 Quick Start (Controller Integration)

use Payerurl\Payerurl;

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

    // $orderItems Is optional
    $orderItems = [
        [
            'name' => str_replace(' ', '_', 'Order item name'), // Replace spaces with '_' , no space allowed
            'qty' => 1,
            'price' => '123',
        ]
    ];

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

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

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

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

Send the customer to $response['redirectUrl'] — they pay with crypto, you receive it instantly in your wallet.

🌐 Supported Cryptocurrencies & Networks

💳 Payment Integration

📌 Function Signature

payment($invoiceId, $amount, $currency = 'usd', $data)

✅ Required Parameters

📦 $data Array Structure

$data = [
    'first_name'   => 'John',
    'last_name'    => 'Doe',
    'email'        => 'john@example.com',
    'redirect_url' => 'https://yourdomain.com/payment-success',
    'cancel_url'   => 'https://yourdomain.com/checkout',
];

The package registers a webhook route automatically (POST /payerurl/notify, route name payerurl.notify). You do not need to pass notify_url in $data.

📲 How the Binance QR Payment Works

1. Your Laravel app calls the API and gets a payment URL
2. Customer is redirected to a secure hosted checkout page
3. Customer scans the QR code with their Binance app
4. Payment is confirmed and funds land directly in your wallet
5. Your notify_url receives a webhook with the order status update

No bank accounts. No intermediaries. No waiting.

🔔 Webhook (Payment Notify)

After payment, Payerurl POSTs to the package endpoint automatically:

• URL: POST {APP_URL}/payerurl/notify
• Route name: payerurl.notify

Verification (public key, signature, order fields) is handled by the package. On successful payment (status_code 200), it fires Payerurl\Events\PaymentNotifySuccess.

Listen in app/Providers/EventServiceProvider.php:

use Payerurl\Events\PaymentNotifySuccess;

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

Example listener:

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

If your app uses the web middleware group on this route, exclude CSRF for the webhook in bootstrap/app.php or VerifyCsrfMiddleware (payerurl/notify).

Optional logging: set PAYERURL_LOG_NOTIFICATIONS=true in .env.

📊 Full Payment Flow Diagram

Your Laravel App → PayerURL API → Checkout Page → Customer Pays (Binance/Crypto)
                                                            ↓
Your Wallet ← Funds (instant) ← Payment Verified ← Blockchain
                                                            ↓
              Your notify_url ← Webhook (order status update)

🔄 API Response

✅ Successful Payment Request

[
    'status'      => true,
    'redirectUrl' => 'https://dash.payerurl.com/payment/WP112XXXXX'
]

❌ Error Response

[
    'status'  => false,
    'message' => 'Something went wrong. Please try again.'
]

🆚 Compared to Other Payment Solutions

🛡️ Security & Privacy

• ✅ Payments go directly to your wallet — PayerURL never holds your funds
• ✅ No mandatory KYC for basic accounts
• ✅ Secure server-to-server API communication
• ✅ Callback verification built into the package
• ✅ API key authentication with HMAC signature
• ✅ No sensitive customer data stored
• ✅ MIT licensed — fully open source, audit it yourself

🌍 Key Features

• ✅ 169+ Fiat Currency Support (USD, EUR, GBP, CAD, BDT, etc.)
• ✅ Real-Time Exchange Rate Conversion
• ✅ Direct Wallet Settlement
• ✅ No KYC Required (Basic Accounts)
• ✅ Secure API Verification
• ✅ Instant Order Status Update via Event/Listener
• ✅ 100% Free & Open Source
• ✅ Laravel 8, 9, 10, 11 Compatible
• ✅ 24/7 Telegram Support

❓ FAQ

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.

🖼 Screenshots

📬 Support

🧾 License

MIT License — free for personal and commercial use.

🏷️ Keywords

crypto payment bitcoin payment laravel binance payment gateway usdt payment laravel usdc payment laravel accept crypto laravel crypto checkout laravel binance qr code laravel trc20 payment erc20 payment no kyc payment gateway direct wallet payment crypto invoice laravel binance pay api payerurl laravel sdk laravel crypto gateway