Simple Crypto Payments

{
    "payment_id": "8a020135-19b7-42df-be4b-1a8722ad0570",
    "amount": "25.00",
    "network": "bsc",
    "token_type": "USDT",
    "to": "0xYourWalletAddress",
    "status": "pending",
    "qr_data": "product=uuideppay&id=8a020135-19b7-42df-be4b-1a8722ad0570",
    "payment_url": "https://eppay.io/payment/8a020135-19b7-42df-be4b-1a8722ad0570",
    "created_at": "2026-02-28T12:00:00+00:00",
    "is_existing": false
}

{
    "payment_id": "8a020135-...",
    "status": "pending",
    "confirmed": false,
    "amount": "25.00",
    "network": "bsc",
    "token_type": "USDT",
    "tx_hash": null,
    "from": null,
    "completed_at": null
}

{
    "payment_id": "8a020135-...",
    "status": "completed",
    "confirmed": true,
    "amount": "25.00",
    "network": "bsc",
    "token_type": "USDT",
    "tx_hash": "0xabc123...",
    "from": "0xSenderAddress",
    "completed_at": "2026-02-28T12:05:30+00:00"
}

{
    "payment_id": "8a020135-...",
    "amount": "25.00",
    "to": "0xYourWalletAddress",
    "from": "0xSenderAddress",
    "network": {
        "slug": "bsc",
        "name": "binance",
        "coin": "BNB"
    },
    "token_type": "USDT",
    "status": "completed",
    "tx_hash": "0xabc123...",
    "created_at": "2026-02-28T12:00:00+00:00",
    "completed_at": "2026-02-28T12:05:30+00:00"
}

{
    "success": true,
    "message": "Payment verified successfully",
    "payment_id": "8a020135-...",
    "status": "completed",
    "tx_hash": "0xabc123...",
    "amount": "25.00",
    "completed_at": "2026-02-28T12:05:30+00:00"
}

{
    "success": "success",
    "message": "Payment verified successfully",
    "payment_id": "8a020135-...",
    "amount": "25.00",
    "tx_hash": "0xabc123...",
    "from": "0xSenderAddress",
    "token_type": "USDT",
    "network": "bsc"
}

[
    {
        "slug": "bsc",
        "name": "binance",
        "coin": "BNB",
        "chain_id": 56,
        "explorer": "https://bscscan.com",
        "tokens": [
            { "type": "USDT", "available": true },
            { "type": "USDC", "available": true }
        ]
    }
]

composer require eppay/laravel-eppay

php artisan vendor:publish --tag=eppay-config

EPPAY_API_KEY=your_api_key_here
EPPAY_DEFAULT_BENEFICIARY=0xYourWalletAddress
EPPAY_DEFAULT_NETWORK=bsc
EPPAY_DEFAULT_TOKEN_TYPE=USDT
EPPAY_SUCCESS_URL=https://yoursite.com/eppay/callback

use EpPay\LaravelEpPay\Facades\EpPay;

// Create payment with defaults from .env
$payment = EpPay::createPayment(amount: 25.00);

// Or specify everything
$payment = EpPay::createPayment(
    amount: 25.00,
    to: '0xWalletAddress',
    network: 'bsc',
    tokenType: 'USDT',
    successUrl: route('payment.callback'),
);

// Response:
// $payment['payment_id']   → "8a020135-..."
// $payment['qr_data']      → "product=uuideppay&id=..."
// $payment['payment_url']  → "https://eppay.io/payment/..."
// $payment['network']      → "bsc"
// $payment['token_type']   → "USDT"

// Rich status response
$status = EpPay::checkStatus($paymentId);
// $status['confirmed']    → true/false
// $status['status']       → "pending" or "completed"
// $status['tx_hash']      → "0x..." (when completed)
// $status['from']         → "0x..." (sender address)
// $status['completed_at'] → "2026-02-28T..."

// Simple boolean check
if (EpPay::isPaymentCompleted($paymentId)) {
    // Payment is done!
}

// Full payment details (with nested network object)
$details = EpPay::getPaymentDetails($paymentId);

// Get QR data string
$qrData = EpPay::getQrCodeData($paymentId);
// → "product=uuideppay&id=8a020135-..."

// Get QR as base64 SVG (for img src)
$qrUrl = EpPay::getQrCodeUrl($paymentId, 300);
// → "data:image/svg+xml;base64,..."

// Get payment page URL
$url = EpPay::getPaymentUrl($paymentId);
// → "https://eppay.io/payment/8a020135-..."

<!-- Auto-polling QR code component -->
<x-eppay-payment-qr
    :payment-id="$paymentId"
    :auto-refresh="true"
    success-url="/payment/success"
    cancel-url="/payment/cancel"
/>

// routes/web.php
Route::post('/eppay/callback', [PaymentController::class, 'handleCallback']);

// In your controller:
public function handleCallback(Request $request)
{
    $paymentId = $request->input('payment_id');
    $txHash    = $request->input('tx_hash');
    $amount    = $request->input('amount');
    $network   = $request->input('network');

    // Verify payment is actually complete (double-check)
    if (!EpPay::isPaymentCompleted($paymentId)) {
        return response()->json(['error' => 'Not confirmed'], 400);
    }

    // Update your order
    Order::where('payment_id', $paymentId)
         ->update(['status' => 'paid', 'tx_hash' => $txHash]);

    return response()->json(['received' => true]);
}

$networks = EpPay::getNetworks();
// Returns array of networks with slug, name, coin, tokens

<script src="https://eppay.io/js/eppay-checkout.js"></script>

<div id="eppay-checkout"></div>
<script src="https://eppay.io/js/eppay-checkout.js"></script>
<script>
  EpPayCheckout.init({
    container: '#eppay-checkout',
    apiKey: 'YOUR_API_KEY',
    to: '0xYourWalletAddress',
    amount: 25.00,                              // Fixed amount (omit for variable)
    successUrl: 'https://yoursite.com/callback', // Server callback URL
    onComplete: function(paymentId) {
      console.log('Payment completed:', paymentId);
      window.location.href = '/thank-you?payment=' + paymentId;
    }
  });
</script>

https://eppay.io/checkout?apiKey=YOUR_API_KEY&to=0xYourWallet&amount=25.00&success=https://yoursite.com/callback