---
title: "Failed payment"
description: "A payment that didn't go through, from the first failure to the final notice."
plan: Pro
docs: https://ui.edbn.me/docs/emails/failed-payment
example: first
---

# Failed payment

A payment that didn't go through, from the first failure to the final notice.

## Installation

This is a Pro item. Once per project, create a token at https://ui.edbn.me/dashboard/tokens, put it in `.env.local` as `EDBN_TOKEN`, and add the registry to `components.json`:

```json
{
  "registries": {
    "@edbn": {
      "url": "https://ui.edbn.me/r/{name}.json",
      "headers": { "Authorization": "Bearer ${EDBN_TOKEN}" }
    }
  }
}
```

Then install:

```bash
npx shadcn@4.19.0 add @edbn/email-failed-payment
```

## Dependencies
- edbn: email-button, email-footer, email-layout, email-shared, email-typography

## Render and send

Render it on the server with its typed props, then pass the result to any email provider. [Sending emails](https://ui.edbn.me/docs/emails/emails-sending.md) has Resend, Postmark and SMTP examples and the dark mode options.

```ts send.ts
import FailedPayment from "@/emails/failed-payment";
import { renderEmail } from "@/emails/_shared/render";

// props: the FailedPaymentProps type and the samples in examples show every field.
const { subject, html, text } = await renderEmail(FailedPayment, props);
await resend.emails.send({ from, to, subject, html, text });
```

## Subjects
- First: "Your Kilnwork payment didn’t go through", previewed as "We couldn’t charge $49.00. We’ll try again on November 18, 2026."
- Retry: "Your Kilnwork payment still didn’t go through", previewed as "We couldn’t charge $49.00. We’ll try again on November 21, 2026."
- Final notice: "Your Kilnwork plan ends on Nov 22", previewed as "$49.00 is still unpaid. Update the card to keep the Studio plan."

## Usage: First

The example code is part of Pro (https://ui.edbn.me/pricing). With the user's token, the edbn MCP server's `get_example` tool returns it: https://ui.edbn.me/mcp

## Examples
- [First](https://ui.edbn.me/docs/emails/failed-payment/first) (Markdown: https://ui.edbn.me/docs/emails/failed-payment.md?demo=first)
- [Retry](https://ui.edbn.me/docs/emails/failed-payment/retry) (Markdown: https://ui.edbn.me/docs/emails/failed-payment.md?demo=retry)
- [Final notice](https://ui.edbn.me/docs/emails/failed-payment/final) (Markdown: https://ui.edbn.me/docs/emails/failed-payment.md?demo=final)

## Files
- emails/failed-payment.tsx (162 lines)

## For agents
- Base theme, once per project: npx shadcn@4.19.0 add https://ui.edbn.me/r/edbn-base.json
- MCP server with search, items, examples and source: https://ui.edbn.me/mcp
- Every page and item: https://ui.edbn.me/llms.txt
