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

Create a Payment

How to prepare a new payment with the Mollie API.

The Code

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

try {
    $payment = $mollie->send(
        new CreatePaymentRequest(
            description: "Order #{$orderId}",
            amount: new Money(currency: 'EUR', value: '10.00'),
            redirectUrl: 'https://example.org/return',
            cancelUrl: 'https://example.org/cancel',
            webhookUrl: 'https://example.org/webhook',
            metadata: ['order_id' => $orderId]
        )
    );

    // Get the checkout URL to redirect the customer to
    $checkoutUrl = $payment->getCheckoutUrl();
} 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;    // "10.00"
$payment->description;      // "Order #1234"
$payment->metadata->order_id; // "1234"
$payment->getCheckoutUrl(); // "https://www.mollie.com/checkout/select-method/7UhSN1zuXS"

Additional Notes

• Always use strings for the amount value to ensure correct decimal precision
• The payment status will be open when initially created
• Store the payment id in your database for reference
• Use webhookUrl to get notified of payment status changes
• The redirectUrl is where your customer will be redirected after the payment
• You can store any custom data in the metadata object
• The checkout URL from getCheckoutUrl() is where you should redirect your customer to complete the payment