PHP SDK

require_once 'vendor/autoload.php';

$client = new \Ligdicash\Ligdicash([
    "api_key"    => "{API_KEY}",
    "auth_token" => "{AUTH_TOKEN}",
    "platform"   => "live",
]);

// 1. Create the invoice
$invoice = $client->Invoice([
    "currency"           => "xof",
    "description"        => "Order #ORD-20240512",
    "customer_firstname" => "Amadou",
    "customer_lastname"  => "Ouedraogo",
    "customer_email"     => "amadou@example.com",
    "store_name"         => "MySuperStore",
    "store_website_url"  => "https://mysuperstore.com",
]);

// 2. Add items
$invoice->addItem([
    "name"        => "Kente shirt",
    "description" => "Size M",
    "quantity"    => 2,
    "unit_price"  => 15000,
]);
$invoice->addItem([
    "name"        => "Shipping fee",
    "description" => "",
    "quantity"    => 1,
    "unit_price"  => 1500,
]);

// 3. Start the payment
$response = $invoice->payWithRedirection([
    "return_url"   => "https://mysuperstore.com/order/success",
    "cancel_url"   => "https://mysuperstore.com/order/cancel",
    "callback_url" => "https://backend.mysuperstore.com/ligdicash/callback",
    "custom_data"  => ["transaction_id" => "ORD-20240512"],
]);

// 4. Redirect the customer
$paymentUrl = $response->response_text;
header("Location: $paymentUrl");
exit;

// 1. Create the invoice
$invoice = $client->Invoice([
    "currency"           => "xof",
    "description"        => "Order #ORD-20240512",
    "customer_firstname" => "Amadou",
    "customer_lastname"  => "Ouedraogo",
    "customer_email"     => "amadou@example.com",
    "store_name"         => "MySuperStore",
    "store_website_url"  => "https://mysuperstore.com",
]);
$invoice->addItem([
    "name" => "Kente shirt", "description" => "Size M",
    "quantity" => 2, "unit_price" => 15000,
]);

// 2. Start the payment (with OTP provided by the customer)
$response = $invoice->payWithoutRedirection([
    "otp"          => "123456",       // OTP code entered by the customer
    "customer"     => "22670123456",  // Customer phone number, no + or spaces
    "callback_url" => "https://backend.mysuperstore.com/ligdicash/callback",
    "custom_data"  => ["transaction_id" => "ORD-20240512"],
]);

// 3. Store the token for later verification
$token = $response->token;

$withdrawal = $client->Withdrawal([
    "amount"      => 5000,
    "description" => "Refund for order ORD-20240510",
    "customer"    => "22670123456",
]);

$response = $withdrawal->send([
    "type"         => "client",
    "to_wallet"    => false,  // false = automatic transfer to the linked mobile money account
    "callback_url" => "https://backend.mysuperstore.com/ligdicash/callback-payout",
    "custom_data"  => ["transaction_id" => "REFUND-20240512"],
]);

$token = $response->token;

$response = $withdrawal->send([
    "type"         => "merchant",  // Direct payout, no intermediate wallet
    "callback_url" => "https://backend.mysuperstore.com/ligdicash/callback-payout",
    "custom_data"  => ["transaction_id" => "PAY-20240512"],
]);

$token = "eyJ0eXAiOiJ...";  // Token returned at creation

// Payin
$transaction = $client->getTransaction([
    "token" => $token,
    "type"  => "payin",  // "payin" or "payout"
]);

if ($transaction->status === "completed") {
    // Deliver the order / validate the payment
} elseif ($transaction->status === "pending") {
    // Payment in progress — retry in a few seconds
} else {
    // Payment failed or cancelled
}

try {
    $response = $invoice->payWithRedirection([
        "return_url"   => "https://mysuperstore.com/success",
        "cancel_url"   => "https://mysuperstore.com/cancel",
        "callback_url" => "https://backend.mysuperstore.com/callback",
        "custom_data"  => ["transaction_id" => "ORD-20240512"],
    ]);
} catch (\InvalidArgumentException $e) {
    // Missing or invalid parameter (currency, type, etc.)
    echo $e->getMessage();
} catch (\Exception $e) {
    // Network error or error returned by the API
    echo $e->getMessage();
}