> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Handling payment errors

When payment for a subscription fails, the subscription appears with a **Payment error** status along with a description of the failure.\
If applicable, Stigg will provide a **payment link** that can be copied and shared with the customer, or opened directly from the Stigg app, to complete the payment.

**Customers will only have access to entitlements they have successfully paid for.**

<Note>
  Receiving notifications about failed payments requires Stigg to be [integrated with a billing solution](/api-and-sdks/integration/overview).
</Note>

## Payment failure when provisioning new subscriptions

If payment fails during the creation of a new subscription:

* The customer does **not** gain access to any entitlements from the new subscription.
* Once payment is successful, the subscription becomes **Active**, and entitlements are granted.

<img src="https://mintcdn.com/stigg/fP4soQQ7PxwZeQ0V/images/docs/f28ed29-Screenshot_2023-08-24_at_14.46.08.png?fit=max&auto=format&n=fP4soQQ7PxwZeQ0V&q=85&s=99863c6537dae77f330bb83aba67cfee" alt="" width="2456" height="708" data-path="images/docs/f28ed29-Screenshot_2023-08-24_at_14.46.08.png" />

## Payment failure when updating an existing subscription

If payment fails during an update of an existing subscription:

* The customer **retains access** to the entitlements from *before* the attempted update.
* The subscription will show **Active** and **Payment error** statuses simultaneously.

In this state, the following actions are supported:

1. **Cancel the update**, keeping the customer on their previous entitlements.
2. **Complete the pending payment**, applying the update and granting the new entitlements.

<img src="https://mintcdn.com/stigg/zZAY_sXPTSVMcwio/images/docs/d5892f4-Screenshot_2023-08-24_at_14.58.00.png?fit=max&auto=format&n=zZAY_sXPTSVMcwio&q=85&s=0bd8d3f13166462a1a47e514c1ee3e68" alt="" width="2472" height="828" data-path="images/docs/d5892f4-Screenshot_2023-08-24_at_14.58.00.png" />

## Failure of a recurring payment

If a recurring payment fails:

* The customer continues to have access to their current entitlements **until the billing solution cancels the subscription**.
* The subscription will show **Active** and **Payment error** statuses at the same time.

<img src="https://mintcdn.com/stigg/rbfzdbhZ6y5pB9n-/images/docs/a248643-Screenshot_2023-08-24_at_15.28.04.png?fit=max&auto=format&n=rbfzdbhZ6y5pB9n-&q=85&s=a4fc41a4ae5f5812adc641c520997e24" alt="" width="2480" height="732" data-path="images/docs/a248643-Screenshot_2023-08-24_at_15.28.04.png" />

## Receiving notifications about failed payments

You can receive notifications about failed payments using Stigg’s\
**[customer.payment\_failed](../../native-integrations/webhooks/events#customer-payment-failed)** webhook.

More information:

<Card title="Integrate Stigg with additional applications using webhooks" horizontal icon="bolt" href="../../native-integrations/webhooks/index" />