uddoktapay/laravel-sdk

UddoktaPay offers a range of payment automation solutions for small entrepreneurs in Bangladesh.

1.0.1 2024-02-12 09:48 UTC

Requires

• php: >=7.4.0

MIT

• UddoktaPay Team

README

The UddoktaPay Laravel SDK allows you to seamlessly integrate the UddoktaPay payment gateway into your Laravel applications.

Table of Contents

• Installation
• Usage
  • Initializing the SDK
  • Initializing a Payment
  • Verifying a Payment
  • Handling IPN Notifications
• Notes

Installation

Run the following command in your project directory:

composer require uddoktapay/laravel-sdk

Usage

Initializing the SDK

use UddoktaPay\LaravelSDK\UddoktaPay;

Initializing a Payment

To initiate a payment, follow these steps:

1. Initialize the UddoktaPay class with your API key and base URL:

$apiKey = "982d381360a69d419689740d9f2e26ce36fb7a50"; // API KEY
$apiBaseURL = "https://sandbox.uddoktapay.com/api/checkout-v2"; // API URL
$uddoktaPay = new UddoktaPay($apiKey, $apiBaseURL);

1. Prepare payment request data and initiate payment:

// Example request data for initializing a payment
$requestData = [
    'full_name'     => "John Doe",
    'email'         => "[e-mail]",
    'amount'        => 10,
    'metadata'      => [
        'example_metadata_key' => "example_metadata_value",
        // ... Add more key-value pairs for dynamic metadata ...
    ],
    'redirect_url'  => 'http://localhost/success.php', // add your success route
    'return_type'   => 'GET',
    'cancel_url'    => 'http://localhost/cancel.php', // add your cancel route
    'webhook_url'   => 'http://localhost/ipn.php', // add your ipn route
];

try {
    $paymentUrl = $uddoktaPay->initPayment($requestData);
    return redirect($paymentUrl);
} catch (\Exception $e) {
     dd("Initialization Error: " . $e->getMessage());
}

Available API Types

The initPayment method allows you to specify the API type as the second parameter. The available options are:

• checkout: Basic checkout API (IPN notification only).
• checkout-v2: Advanced checkout API (default, Success Page notification only).
• checkout/global: Global basic checkout API (IPN notification only).
• checkout-v2/global: Global advanced checkout API (Success Page notification only).

Verifying a Payment

To verify a payment, follow these steps:

1. Initialize the UddoktaPay class as shown in the previous steps.

2. Get the invoice ID from the payment success page:

$invoiceId = $request->invoice_id;

1. Verify the payment:

try {
    $response = $uddoktaPay->verifyPayment($invoiceId);
    dd($response); // Display the verification response
} catch (\Exception $e) {
    dd("Verification Error: " . $e->getMessage());
}

Handling IPN Notifications (Optional)

To handle IPN (Instant Payment Notification) requests, follow these steps:

1. Initialize the UddoktaPay class as shown in the previous steps.

2. Use the executePayment method:

try {
    $ipnResponse = $uddoktaPay->executePayment();
    dd($ipnResponse);
} catch (\Exception $e) {
     dd("Error: " . $e->getMessage());
}

Notes

• Replace "API KEY" with your actual API key.
• Adjust the request data and other details according to your project requirements.
• The metadata field is dynamic; you can add multiple key-value pairs as needed.
• Make sure to handle errors using try-catch blocks as demonstrated above.