Learn how to validate payment methods before creating, upgrading, or downgrading customer subscriptions.
Beta Feature
This feature is currently in beta. The behavior, request parameters, and response format may change before the final release.
Stripe Integration Only
While Lago supports multiple payment providers, payment pre-authorization is currently only available with Stripe.
By default, when creating a subscription, Lago follows this process:
This means it’s possible to create an active subscription for a customer even if the payment later fails. While this behavior is intentional, it may not be ideal for all use cases.
To address this, Lago now offers payment pre-authorization, allowing you to verify the validity of a payment method for a specific amount before creating the subscription.
Important: If the pre-authorization fails, the entire process is aborted and no subscription is created.
Pre-authorization creates a Payment Intent in Stripe to verify that the payment amount can be collected. When successful, the amount is temporarily held on the customer’s account but not captured.
Note: The held funds are automatically released immediately after successful verification.
Pre-authorization can fail for several reasons:
Please note that if 3D Secure authentication is required, it may prevent subscription creation.
While pre-authorization helps reduce payment failures, it cannot guarantee successful invoice payment because:
To implement pre-authorization, use the POST /api/v1/subscriptions
endpoint with additional parameters. The standard subscription
parameters remain unchanged.
You must manually specify the amount to authorize, as the final amount (including taxes) is only calculated during invoice generation.
Learn how to validate payment methods before creating, upgrading, or downgrading customer subscriptions.
Beta Feature
This feature is currently in beta. The behavior, request parameters, and response format may change before the final release.
Stripe Integration Only
While Lago supports multiple payment providers, payment pre-authorization is currently only available with Stripe.
By default, when creating a subscription, Lago follows this process:
This means it’s possible to create an active subscription for a customer even if the payment later fails. While this behavior is intentional, it may not be ideal for all use cases.
To address this, Lago now offers payment pre-authorization, allowing you to verify the validity of a payment method for a specific amount before creating the subscription.
Important: If the pre-authorization fails, the entire process is aborted and no subscription is created.
Pre-authorization creates a Payment Intent in Stripe to verify that the payment amount can be collected. When successful, the amount is temporarily held on the customer’s account but not captured.
Note: The held funds are automatically released immediately after successful verification.
Pre-authorization can fail for several reasons:
Please note that if 3D Secure authentication is required, it may prevent subscription creation.
While pre-authorization helps reduce payment failures, it cannot guarantee successful invoice payment because:
To implement pre-authorization, use the POST /api/v1/subscriptions
endpoint with additional parameters. The standard subscription
parameters remain unchanged.
You must manually specify the amount to authorize, as the final amount (including taxes) is only calculated during invoice generation.