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

Feature	Detail
🏦 No merchant account needed	Payments go directly to your crypto wallet
🌍 169+ fiat currencies	USD, EUR, GBP, CAD and more — converted at live rates
⚡ 10-minute integration	Simple composer install, clear docs, copy-paste code
🔒 No KYC for basic accounts	Start accepting payments without identity verification
📱 Binance QR Code payments	Customers scan and pay without leaving your app
💸 Zero hidden fees	No network surcharges or platform fees on the plugin
🛠️ Laravel 8, 9, 10, 11 ready	Works with any modern Laravel version

📦 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

Currency	Networks
USDT	TRC20 (Tron), ERC20 (Ethereum), BEP20 (BSC)
USDC	ERC20 (Ethereum), BEP20 (BSC)
Bitcoin (BTC)	Bitcoin Network
Ethereum (ETH)	ERC20
Binance Pay	Binance QR Code

💳 Payment Integration

📌 Function Signature

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

✅ Required Parameters

Parameter	Type	Required	Description
$invoiceId	string	Yes	Unique Order ID
$amount	int	Yes	Amount in smallest unit (e.g., cents)
$currency	string	No	Default: usd
$data	array	Yes	Customer & URL information

📦 $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

	PayerURL (This Package)	Stripe / PayPal	Coinbase Commerce
No merchant account	✅	❌	✅
Direct to your wallet	✅	❌	Partial
No KYC required	✅ (Basic)	❌	❌
Binance QR support	✅	❌	❌
Laravel SDK	✅	✅	✅
169+ fiat currencies	✅	Partial	❌
Zero platform fees	✅	❌	❌

🛡️ 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

Channel	Link
💬 Telegram	t.me/Payerurl
🌐 Website	payerurl.com
📧 Email	support@payerurl.com
📊 Dashboard	dash.payerurl.com
🔴 Live Demo	payerurl.com

🧾 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