---
title: "A payment attempt for a payment request has failed on a payment provider"
method: POST
path: "payment_request_payment_failure"
---

# A payment attempt for a payment request has failed on a payment provider

`POST payment_request_payment_failure` (webhook)

A payment attempt for a payment request has failed on a payment provider

## Headers

- `X-Lago-Signature` string, required
- `X-Lago-Signature-Algorithm` 'jwt' | 'hmac', required
- `X-Lago-Unique-Key` string, uuid, required

## Payload

- object
  - `webhook_type` 'payment_request.payment_failure', required
  - `object_type` 'payment_provider_payment_request_payment_error', required
  - `organization_id` string, uuid, required: Unique identifier of the organization, created by Lago.
  - `payment_provider_payment_request_payment_error` PaymentRequestPaymentFailureObject, required
    - `lago_payment_request_id` string, uuid, required: Unique identifier assigned to the payment request within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the payment request record within the Lago system.
    - `lago_invoice_ids` string[], required: List of unique identifiers assigned to the invoices within the Lago application. These IDs are exclusively created by Lago and serve as unique identifiers for the invoices records within the Lago system.
    - `lago_customer_id` string, uuid, required: Unique identifier assigned to the customer within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the customer's record within the Lago system.
    - `external_customer_id` string, required: The customer external unique identifier (provided by your own application)
    - `provider_customer_id` string: Unique identifier of the customer within the payment provider
    - `payment_provider` 'adyen' | 'cashfree' | 'gocardless' | 'moneyhash' | 'stripe', required: The type of payment provider
    - `payment_provider_code` string: Code of the payment provider
    - `provider_error` union
      - string
      - object

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) - [All operations](https://skmtc.dev/getlago/apis/lago-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/getlago/apis/lago-api-documentation/revisions/b216574b9612?raw)