PHP API Integration Integration

1📋 Requirements

• PHP 7.4 or higher
• PHP extensions: curl, json
• A publicly accessible HTTPS domain for the notify_url webhook
• Free PayerURL merchant account at dash.payerurl.com

2🔑 Get Your API Keys (Free)

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

👉 No credit card required. Get your keys at: dash.payerurl.com/profile/api-management

3⚙️ Quick Start Configuration

Set your order details, customer info, and API keys:

// 1. Set your order details
$invoiceid = floor(microtime(true) * 1000); // unique order ID
$amount    = 120.00;
$currency  = 'usd';

// 2. Set customer info
$billing_fname = 'John';
$billing_lname = 'Doe';
$billing_email = '[email protected]';

// 3. Set URLs
$redirect_to = 'https://yoursite.com/payment-success';
$notify_url  = 'https://yoursite.com/payment-notify';
$cancel_url  = 'https://yoursite.com/checkout';

// 4. Set API keys (use env vars in production)
$payerurl_public_key = $_ENV['PAYERURL_PUBLIC_KEY'];
$payerurl_secret_key = $_ENV['PAYERURL_SECRET_KEY'];

4🛒 Build the Items Array

Each item must use underscores instead of spaces in the name:

$items = [
    [
        'name'  => 'Product_Name', // No spaces — use underscore
        'qty'   => '2',            // String, integer value
        'price' => '60.00',        // String, float value
    ]
];

5🚀 Full Payment Request Example

<?php
$invoiceid           = floor(microtime(true) * 1000);
$amount              = 120.00;
$currency            = 'usd';
$billing_fname       = 'John';
$billing_lname       = 'Doe';
$billing_email       = '[email protected]';
$redirect_to         = 'https://yoursite.com/payment-success';
$notify_url          = 'https://yoursite.com/payment-notify';
$cancel_url          = 'https://yoursite.com/checkout';
$payerurl_public_key = $_ENV['PAYERURL_PUBLIC_KEY'];
$payerurl_secret_key = $_ENV['PAYERURL_SECRET_KEY'];

$items = [
    ['name' => 'Product_Name', 'qty' => '10', 'price' => '12.00']
];

$args = [
    'order_id'      => $invoiceid,
    'amount'        => $amount,
    'items'         => $items,
    'currency'      => strtolower(trim($currency)),
    'billing_fname' => $billing_fname,
    'billing_lname' => $billing_lname,
    'billing_email' => $billing_email,
    'redirect_to'   => $redirect_to,
    'notify_url'    => $notify_url,
    'cancel_url'    => $cancel_url,
    'type'          => 'php',
];

ksort($args);
$args      = http_build_query($args);
$signature = hash_hmac('sha256', $args, $payerurl_secret_key);
$authStr   = base64_encode($payerurl_public_key . ':' . $signature);

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => 'https://api-v2.payerurl.com/api/payment',
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS     => $args,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/x-www-form-urlencoded;charset=UTF-8',
        'Authorization: Bearer ' . $authStr,
    ],
]);

$response = json_decode(curl_exec($ch));
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200 && !empty($response->redirectTO)) {
    header('Location: ' . $response->redirectTO);
}
exit();

6🔔 Webhook — Payment Notify Handler

PayerURL POSTs to your notify_url after every payment. Add your order update logic where shown:

// ✅ All security checks passed at this point
$data = ['status' => 2040, 'message' => $GETDATA];

// YOUR CODE HERE — e.g.:
// DB::update('orders', ['status' => 'paid'], ['id' => $GETDATA['order_id']]);
// sendConfirmationEmail($GETDATA['billing_email']);

header('Content-Type: application/json; charset=utf-8');
echo json_encode($data);
exit();