PHP code example of monei / monei-php-sdk

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

monei / monei-php-sdk example snippets

// Example of loading API key from environment variable (recommended)
$apiKey = getenv('MONEI_API_KEY');
$monei = new Monei\MoneiClient($apiKey);

Monei\Model\CreatePaymentRequest;
use Monei\Model\PaymentCustomer;

// Instantiate the client using the API key
$monei = new Monei\MoneiClient('YOUR_API_KEY');

try {
    // Using request classes for better type safety and IDE autocompletion
    $request = new CreatePaymentRequest([
        'amount' => 1250, // 12.50€
        'order_id' => '100100000001',
        'currency' => 'EUR',
        'description' => 'Items description',
        'customer' => new PaymentCustomer([
            'email' => '[email protected]',
            'name' => 'John Doe'
        ])
    ]);
    
    $result = $monei->payments->create($request);
    print_r($result);
} catch (Exception $e) {
    echo 'Error while creating payment: ', $e->getMessage(), PHP_EOL;
}

Monei\Model\CreatePaymentRequest;
use Monei\Model\PaymentCustomer;
use Monei\Model\PaymentBillingDetails;
use Monei\Model\Address;

$monei = new Monei\MoneiClient('YOUR_API_KEY');

try {
    $request = new CreatePaymentRequest([
        'amount' => 1999, // Amount in cents (19.99)
        'order_id' => '12345',
        'currency' => 'EUR',
        'description' => 'Order #12345',
        'customer' => new PaymentCustomer([
            'email' => '[email protected]',
            'name' => 'John Doe',
            'phone' => '+34600000000'
        ]),
        'billing_details' => new PaymentBillingDetails([
            'address' => new Address([
                'line1' => '123 Main St',
                'city' => 'Barcelona',
                'country' => 'ES',
                'zip' => '08001'
            ])
        ]),
        'complete_url' => 'https://example.com/success',
        'fail_url' => 'https://example.com/failure',
        'callback_url' => 'https://example.com/webhook'
    ]);
    
    $result = $monei->payments->create($request);
    print_r($result);
} catch (Exception $e) {
    echo 'Error while creating payment: ', $e->getMessage(), PHP_EOL;
}

Monei\ApiException;

$monei = new Monei\MoneiClient('YOUR_API_KEY');

try {
    $payment = $monei->payments->getPayment('pay_123456789');
    echo "Payment status: " . $payment->getStatus() . PHP_EOL;
} catch (ApiException $e) {
    echo 'Error retrieving payment: ', $e->getMessage(), PHP_EOL;
}

Monei\Model\RefundPaymentRequest;
use Monei\ApiException;

$monei = new Monei\MoneiClient('YOUR_API_KEY');

try {
    $refundRequest = new RefundPaymentRequest([
        'amount' => 500, // Partial refund of 5.00€
        'refund_reason' => 'Customer request'
    ]);
    
    $result = $monei->payments->refund('pay_123456789', $refundRequest);
    echo "Refund created with ID: " . $result->getId() . PHP_EOL;
} catch (ApiException $e) {
    echo 'Error refunding payment: ', $e->getMessage(), PHP_EOL;
}

Monei\Model\CreatePaymentRequest;
use Monei\Model\PaymentCustomer;

$monei = new Monei\MoneiClient('YOUR_API_KEY');

try {
    $request = new CreatePaymentRequest([
        'amount' => 110, // Amount in cents (1.10)
        'currency' => 'EUR',
        'order_id' => '14379133960355',
        'description' => 'Test Shop - #14379133960355',
        'customer' => new PaymentCustomer([
            'email' => '[email protected]'
        ]),
        'callback_url' => 'https://example.com/checkout/callback', // For asynchronous notifications
        'complete_url' => 'https://example.com/checkout/complete', // Redirect after payment
        'fail_url' => 'https://example.com/checkout/cancel' // Redirect if customer cancels
    ]);
    
    $result = $monei->payments->create($request);
    
    // Redirect the customer to the payment page
    if (isset($result->getNextAction()) && isset($result->getNextAction()->getRedirectUrl())) {
        header('Location: ' . $result->getNextAction()->getRedirectUrl());
        exit;
    }
} catch (Exception $e) {
    echo 'Error while creating payment: ', $e->getMessage(), PHP_EOL;
}

Monei\Model\PaymentStatus;
use Monei\ApiException;

$monei = new Monei\MoneiClient('YOUR_API_KEY');

// Parse raw body for signature verification
$rawBody = file_get_contents('php://input');

// Get the signature from the headers
$signature = $_SERVER['HTTP_MONEI_SIGNATURE'] ?? '';

try {
    // Verify the signature and get the decoded payload
    $payload = $monei->verifySignature($rawBody, $signature);
    
    // Process the webhook
    $eventType = $payload->type;
    
    // The data field contains the Payment object
    $payment = $payload->object;
    
    // Access Payment object properties directly
    $paymentId = $payment->id;
    $amount = $payment->amount;
    $currency = $payment->currency;
    $status = $payment->status;
    
    // Handle the event based on its type
    switch ($eventType) {
        case 'payment.succeeded':
            // Handle successful payment
            echo "Payment {$paymentId} succeeded: " . ($amount/100) . " {$currency}\n";
            break;
        case 'payment.failed':
            // Handle failed payment
            echo "Payment {$paymentId} failed with status: {$status}\n";
            break;
        // Handle other event types
    }
    
    http_response_code(200);
    echo json_encode(['received' => true]);
} catch (ApiException $e) {
    // Invalid signature
    http_response_code(401);
    echo json_encode(['error' => 'Invalid signature']);
}

Monei\Model\PaymentStatus;
use Monei\ApiException;

$monei = new Monei\MoneiClient('YOUR_API_KEY');

// Parse raw body for signature verification
$rawBody = file_get_contents('php://input');
$signature = $_SERVER['HTTP_MONEI_SIGNATURE'] ?? '';

try {
    // Verify the signature
    $payment = $monei->verifySignature($rawBody, $signature);
    
    // Update your order status based on the payment status
    if ($payment->status === PaymentStatus::SUCCEEDED) {
        // Payment successful - fulfill the order
        // Update your database, send confirmation email, etc.
    } else if ($payment->status === PaymentStatus::FAILED) {
        // Payment failed - notify the customer
        // Log the failure, update your database, etc.
    } else if ($payment->status === PaymentStatus::AUTHORIZED) {
        // Payment is authorized but not yet captured
        // You can capture it later
    } else if ($payment->status === PaymentStatus::CANCELED) {
        // Payment was canceled
    }
    
    // Acknowledge receipt of the webhook
    http_response_code(200);
    echo json_encode(['received' => true]);
} catch (ApiException $e) {
    // Invalid signature
    http_response_code(401);
    echo json_encode(['error' => 'Invalid signature']);
}

Monei\Model\CreatePaymentRequest;

// Initialize with your partner API key
$monei = new Monei\MoneiClient('YOUR_PARTNER_API_KEY');

// Set a custom User-Agent for your platform (rchant
try {
    $request = new CreatePaymentRequest([
        'amount' => 1250,
        'order_id' => '12345',
        'currency' => 'EUR'
    ]);
    
    $result = $monei->payments->create($request);
    print_r($result);
} catch (Exception $e) {
    echo 'Error while creating payment: ', $e->getMessage(), PHP_EOL;
}

// For a platform named "ShopManager" with version 2.1.0
$monei->setUserAgent('MONEI/ShopManager/2.1.0');

// For a platform named "PaymentHub" with version 3.0.1
$monei->setUserAgent('MONEI/PaymentHub/3.0.1');

Monei\Model\CreatePaymentRequest;

// Initialize with your partner API key
$monei = new Monei\MoneiClient('YOUR_PARTNER_API_KEY');

// Set a custom User-Agent for your platform
$monei->setUserAgent('MONEI/YourPlatform/1.0.0');

// Function to process payments for multiple merchants
function processPaymentsForMerchants($monei, $merchantAccounts) {
    $results = [];

    foreach ($merchantAccounts as $merchantId) {
        // Set the current merchant account
        $monei->setAccountId($merchantId);

        // Process payment for this merchant
        try {
            $request = new CreatePaymentRequest([
                'amount' => 1000,
                'order_id' => 'order-' . $merchantId . '-' . time(),
                'currency' => 'EUR'
            ]);
            
            $payment = $monei->payments->create($request);
            $results[$merchantId] = [
                'success' => true,
                'payment' => $payment
            ];
        } catch (Exception $e) {
            $results[$merchantId] = [
                'success' => false,
                'error' => $e->getMessage()
            ];
        }
    }

    return $results;
}

// Example usage
$merchantAccounts = ['merchant_1', 'merchant_2', 'merchant_3'];
$results = processPaymentsForMerchants($monei, $merchantAccounts);
print_r($results);

bash
composer