telvero-sales-backoffice/vendor/mollie/mollie-api-php/docs/recipes/payments/create-ideal-payment.md

Create an iDEAL Payment

How to prepare a new iDEAL payment with the Mollie API.

The Code

use Mollie\Api\Http\Data\Money;
use Mollie\Api\Http\Requests\CreatePaymentRequest;
use Mollie\Api\Types\PaymentMethod;

try {
    // Generate a unique order ID
    $orderId = time();

    // Create the payment
    $payment = $mollie->send(
        new CreatePaymentRequest(
            description: "Order #{$orderId}",
            amount: new Money(currency: 'EUR', value: '27.50'),
            redirectUrl: "https://example.com/return.php?order_id={$orderId}",
            cancelUrl: "https://example.com/cancel.php",
            webhookUrl: "https://example.com/webhook.php",
            metadata: ['order_id' => $orderId],
            method: PaymentMethod::IDEAL
        )
    );

    // Store the order in the database
    database_write($orderId, $payment->status);

    // Redirect to checkout
    header('Location: ' . $payment->getCheckoutUrl(), true, 303);
} catch (\Mollie\Api\Exceptions\ApiException $e) {
    echo 'API call failed: ' . htmlspecialchars($e->getMessage());
}

The Response

$payment->id;                // "tr_7UhSN1zuXS"
$payment->status;           // "open"
$payment->amount->currency; // "EUR"
$payment->amount->value;    // "27.50"
$payment->description;      // "Order #1234"
$payment->metadata->order_id; // "1234"
$payment->method;          // "ideal"
$payment->getCheckoutUrl(); // "https://www.mollie.com/checkout/select-method/7UhSN1zuXS"

Additional Notes

• The iDEAL payment method is only available for payments in EUR
• The bank selection is now handled by iDEAL
• The webhook will be called when the payment status changes, so make sure to implement the webhook handler to process status updates