Webhook Handling Error in Laravel Cashier Mollie

[iamaks1993]

### Description
When handling the Mollie webhook for first-time payments, the webhook initially fails with an internal server error on the first one or two attempts, but typically succeeds on the third attempt.

Each failed attempt throws a different error:

1. No customer exists with token cst_xxxxx

2. Invalid customer mandate
   (Related issue: #269)

3. Undefined property: stdClass::$actions
   (Related issue: #202)

We're using newSubscriptionViaMollieCheckout() to initiate checkout and are currently on Laravel Cashier Mollie v2.17, with no customization.

Log File
laravel.log

Video of issue
https://www.awesomescreenshot.com/video/39049454?key=24c3f3b0d821ba72849f8f79cda018da

Screenshot Of webhook
In this you can see that first 2 webhook calls are failed and 3rd succeeds.

[sandervanhooft]

Hi @iamaks1993 ,

It looks that somehow the billable model already has an invalid mollie customer id attached. Can you share a code sample so I can reproduce the issue here?

[iamaks1993]

@sandervanhooft Thanks for the quick response. The main issue is, I am facing all those 3 issue randomly. Please find the snippet below. Let me know, if you need anything else. Thanks again.

User model

public function getInvoiceInformation(): array
{
    return [$this->name, $this->email];
}

public function mollieCustomerFields(): array
{
    return [
        'email' => $this->email,
        'name' => $this->name,
    ];
}


public function getExtraBillingInformation(): ?string
{
    return null;
} 

Plan Model

  private function getAmount(): Money
  {
      return new Money((int) round($this->price * 100), new Currency(self::CURRENCY));
  }

  public function buildCashierPlan(): CashierPlan
  {
      $plan = new CashierPlan($this->name);

      return $plan->setAmount($this->getAmount())
          // Default 1 for 1 year
          ->setInterval("1 {$this->interval->value}")
          ->setDescription($this->description ?? '')
          ->setFirstPaymentMethod(config('cashier.first_payment.method'))
          ->setFirstPaymentAmount($this->getAmount())
          ->setFirstPaymentDescription($this->description ?? '')
          ->setFirstPaymentRedirectUrl(route('filament.admin.pages.mollie-subscription-status'))
          ->setFirstPaymentWebhookUrl(Cashier::firstPaymentWebhookUrl())
          ->setOrderItemPreprocessors(Preprocessors::fromArray(config('cashier_plans.defaults.order_item_preprocessors')));
  }

Create Subscription Action Class

 class CreateSubscription
 {
   
    public function __construct(public User $user, public string $planName) {}

    public function handle(): ?string
    {
        try {
            $response = $this->user
                ->newSubscriptionViaMollieCheckout('main', $this->planName)
                ->create();

            return $response->getTargetUrl();
        } catch (Throwable $throwable) {
            Log::error('Unable to create subscription.', [
                'user_id' => $this->user?->id,
                'plan_name' => $this->planName,
                'throwable' => $throwable,
            ]);

            return null;
        }
    }
}

Caller Usage

public function subscribe(): void
{
   
    try {

        $user = auth()->user();

       $checkoutUrl = (new CreateSubscription($user, $this->selectedPlan))->handle();
        if ($checkoutUrl) {
            redirect()->away($checkoutUrl);
        } else {
            $this->showErrorNotification();
        }

    } catch (Throwable $throwable) {
        Log::error('Unable to subscribe subscription', [
            'user_id' => $user?->id,
            'plan' => $this->selectedPlan,
            'throwable' => $throwable,
        ]);

        $this->showErrorNotification();
    }
}

[evertjanMlbrgn]

I've seen these logs mentioned in this report too and i'm on the same version. Not sure how to reproduce.

At the moment i get the following log message: [2025-04-23 19:41:41] local.ERROR: The customer mandate is still pending {"exception":"[object] (Laravel\Cashier\Exceptions\MandateIsNotYetFinalizedException(code: 404): The customer mandate is still pending at ...../vendor/mollie/laravel-cashier-mollie/src/Billable.php:509)

one minute later the webhook is called succesfully.
[2025-04-23 19:42:42] local.INFO: Event SubscriptionStarted is handled. OwnerType: App\Models\CustomerProfile OwnerId: 9

Not sure if this finding is related to what iamaks1993 reported, and maybe it was designed to work this way. Just mentioning it.

[sandervanhooft]

1. No customer exists with token cst_xxxxx
2. Invalid customer mandate
   (Related issue: #269)
3. Undefined property: stdClass::$actions
   (Related issue: #202)

Regarding point 2 @evertjanMlbrgn indeed could be correct here that it's about a mandate not being ready yet. By throwing that exception Mollie will retry the webhook with an exponential back-off, which is desired behavior here. At the time this exception was introduced assuming it was occurring infrequently. How frequent is this happening, how many different transactions are involved?

[iamaks1993]

@sandervanhooft Thanks for reply.

During my testing its single transaction for a moment. 4 days ago, I faced the issue 8/10 times.

Today I tried to reproduce the issue but did not encounter the problems I had listed earlier. However, once I received an error: "The customer mandate is still pending."

[obi12341]

we exactly hit the same bug in test-mode:

"The customer mandate is still pending in file /var/www/html/vendor/mollie/laravel-cashier-mollie/src/Billable.php on line 510"

[Rowangz]

Hi, any updates on this issue? Especially for the "The customer mandate is still pending" error. I am only getting this with Belfius payments. iDEAL, KBC and Bancontact work as expected.

edit: in the span of 4 hours, Mollie retried the webhook 9 times, with each time the same erorr. This has happened in three cases, all Belfius payments.

[Rowangz]

Update: The issue with Belfius comes from the fact that the mandate is finalised the morning after the payment, see issue on the Mollie PHP api package: mollie/mollie-api-php#66

Any tips on how to create a workaround for this? Or maybe set up some logic that if it's a belfius payment, the mandate will be set up the day after?

[sandervanhooft]

Thanks for following up. Let me investigate this and get back to you.

[fjbender]

In mollie/mollie-api-php#66 (comment) it's already confirmed that Belfius doesn't share the IBAN with us when we process the payment, but only when we receive the money. This is why the mandate needs to remain pending until that time. As the payment is guaranteed, we should be confident to set up the subscription though. This bit

laravel-cashier-mollie/src/Billable.php

Lines 509 to 511 in 85def4e

	if ($this->pendingMollieMandate()) {
	throw new MandateIsNotYetFinalizedException();
	}

should probably not throw an exception.

[obi12341]

it is not just belfius, we also discover this on paypal

[timvandijck]

Yeah, it's not related to the bank itself because it's also an issue on testmode.

[sandervanhooft]

The exception was introduced because of this issue: #70 . I'll take a look to see if the throwing can be scoped down. At first glance it's not how the behavior for recurring payments is advertised @fjbender

[sandervanhooft]

The exception was introduced because of this issue: #70 . I'll take a look to see if the throwing can be scoped down. At first glance it's not how the behavior for recurring payments is advertised @fjbender

Hm having a pending mandate is actually expected behavior here, my bad. Let me see what's the best approach to handle this here.

@fjbender given the rise in reported occurrences, could part of this (outside of Belfius) be caused by "eventual consistency" issues. This would mean it could be solved using a delay/retry.

[timvandijck]

Some info that might be usefull: one thing I noticed (in production with Belfius) is that the error is triggered by the missing mandate id, but when I did a request to the Mollie API to lookup the payment, the payment did contain the mandate in that response.