Skip to content

Billing and orders

Failed payment email template.

Say a payment did not go through, why, when it will be tried again, and how to fix it.

Look

SubjectWe could not take your payment for Acme

PreviewUpdate your payment method to keep your account active.

Shown inApple Mail and iPhone Mail switch automatically

The preview uses example data, so no real names or numbers. Mail programs differ: send one to your own inbox before you rely on it.

When to send it

When a renewal or charge is declined. People are not at fault in most cases, so the tone should be calm and the fix should be one click away.

Get it right

  • Say what failed, for how much, and why if you know. "Your card was declined" is clearer than "a problem occurred".
  • Say when you will try again, and when access ends if it still fails.
  • Use one button to update the payment method.
  • Send a short series spread over several days, not one email and not five in an hour.

Use it in Mailtruss

Choose New template, pick Payment failed, change the words and colours, and publish. 3,000 emails a month are free, with no credit card.

Variables

Wrap a name in double braces and Mailtruss fills it in when you send. A value after a bar is the fallback when you leave it out, such as {{first_name | there}}. Values are escaped, so a name with markup in it cannot break the message.

VariableWhat it isExampleNeeded?
app_nameYour product or company name.AcmeYes
first_nameThe person's first name. Optional; the email says "there" without it.AnaOptional
plan_nameWhat the payment was for.Pro planYes
amount_dueThe amount that failed, formatted.$29.00Yes
failure_reasonWhy it failed, in plain words. Optional.Your card was declinedOptional
retry_dateWhen you will try again. Optional.19 November 2026Optional
update_urlWhere the person updates their payment method.https://app.example.com/billingYes
footer_textThe small print at the bottom, such as your company name and postal address. Optional: a short note about why the person got this email is used when you leave it out.Acme Inc, 1 Main Street, SpringfieldOptional

Create it and send it

Create the template from this starter with one request (or from the dashboard), then send it by its alias with your values. Only the published version is ever sent. Other languages are on send email by language.

Create the template
curl -X POST https://mailtruss.com/api/v1/templates \
-H "Authorization: Bearer $MAILTRUSS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "starter": "payment-failed", "look": "bold", "alias": "payment-failed", "publish": true }'
send.ts
import { MailClient } from "mailtruss";
​
const mail = new MailClient({ apiKey: process.env.MAILTRUSS_API_KEY! });
​
await mail.emails.send(
{
from: "Acme <hello@yourdomain.com>",
to: "person@example.com",
template: {
id: "payment-failed", // the alias you gave the template
variables: {
app_name: "Acme",
plan_name: "Pro plan",
amount_due: "$29.00",
update_url: "https://app.example.com/billing",
},
},
},
{ idempotencyKey: "payment-failed-<your-event-id>" }, // makes retries safe
);

The HTML and the text

This is exactly what the starter produces. Copy it into any system that sends HTML, or use it in Mailtruss to keep editing visually.

payment-failed.html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="color-scheme" content="light dark">
<meta name="supported-color-schemes" content="light dark">
<style>@media only screen and (max-width:520px){.mt-card{width:100%!important;border-radius:0!important}.mt-px{padding-left:22px!important;padding-right:22px!important}.mt-col{display:block!important;width:100%!important;padding:0 0 18px 0!important}.mt-hero,.mt-section{padding:24px 20px!important}.mt-title{font-size:26px!important}}@media (prefers-color-scheme:dark){.mt-pagebg,.mt-page{background:#0e0f12!important}.mt-card{background:#17181c!important;border-color:#2b2d34!important}.mt-title,.mt-subtitle,.mt-heading,.mt-value,.mt-quote{color:#f1f1f4!important}.mt-text,.mt-li,.mt-list{color:#cfd0d8!important}.mt-label,.mt-small,.mt-footer,.mt-unsub,.mt-footer a{color:#9b9da8!important}.mt-rule{border-color:#2b2d34!important}.mt-tone-tint,.mt-tone-card{background:#21232a!important;border-color:#2b2d34!important}.mt-tone-tint .mt-title,.mt-tone-card .mt-title{color:#f1f1f4!important}.mt-code,.mt-codeblock,.mt-linkbox{background:#111216!important;color:#f1f1f4!important}.mt-inline-code{background:#21232a!important;color:#f1f1f4!important}.mt-link{color:#dd5e4c!important}.mt-brandtext{color:#dd5e4c!important}.mt-btncell{background:#d4361f!important;border-color:#d4361f!important}.mt-button{color:#ffffff!important}.mt-ghost{background:transparent!important;border-color:#dd5e4c!important}.mt-ghost .mt-button{color:#dd5e4c!important}.mt-badge-neutral{background:#21232a!important;color:#f1f1f4!important}.mt-mark,.mt-stepnum{background:#d4361f!important;color:#ffffff!important}.mt-markdot{background:#ffffff!important}.mt-tone-accent,.mt-tone-dark{border:1px solid #2b2d34!important}.mt-co-info{background:#1f2b44!important;color:#c8d7f3!important}.mt-co-success{background:#192f23!important;color:#c0dbc8!important}.mt-co-warning{background:#3a2d1d!important;color:#ebd9c0!important}.mt-co-danger{background:#3c1e1f!important;color:#edc6c4!important}}</style>
</head>
<body class="mt-page" style="margin:0;padding:0;background:#fff3ee">
<div style="display:none;max-height:0;overflow:hidden;opacity:0;color:transparent;mso-hide:all">Update your payment method to keep your account active.&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;</div>
<table class="mt-pagebg" role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background:#fff3ee">
<tr>
<td align="center" style="padding:32px 12px">
<table class="mt-card" role="presentation" width="600" cellpadding="0" cellspacing="0" style="width:100%;max-width:600px;background:#ffffff;border-radius:0px;border:1px solid #16110f;border-collapse:separate">
<tr>
<td class="mt-brand mt-px" style="padding:20px 40px;background:#d4361f;border-radius:0px 0px 0 0;text-align:left">
<table role="presentation" cellpadding="0" cellspacing="0" border="0" >
<tr>
<td style="padding:0 10px 0 0;vertical-align:middle">
<table role="presentation" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-bandmark" width="30" height="30" align="center" valign="middle" style="width:30px;height:30px;background:#ffffff;border-radius:2px">
<table role="presentation" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-bandmarkdot" width="10" height="10" style="width:10px;height:10px;line-height:10px;font-size:1px;background:#d4361f;border-radius:50%">&nbsp;</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
<td class="mt-bandtext" style="vertical-align:middle;font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:17px;font-weight:700;letter-spacing:-0.2px;color:#ffffff">{{app_name | Your app}}</td>
</tr>
</table>
</td>
</tr>
<tr>
<td style="height:28px;line-height:1px;font-size:1px">&nbsp;</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 22px">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border-collapse:separate">
<tr>
<td class="mt-hero mt-tone-dark" style="background:#140f0e;background-image:linear-gradient(135deg,#140f0e 0%,#0e0b0a 100%);border-radius:0px;padding:34px 30px;text-align:left">
<div class="mt-eyebrow" style="font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:12px;font-weight:700;letter-spacing:1.4px;text-transform:uppercase;color:#bdbcbc;margin:0 0 12px">Action needed</div>
<h1 class="mt-title" style="margin:0;font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:36px;font-weight:800;line-height:108%;letter-spacing:-1.2px;text-decoration:none;color:#ffffff;text-align:left">We could not take your payment</h1>
<p class="mt-text" style="margin:12px 0 0;font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:16px;font-weight:400;line-height:160%;letter-spacing:0px;text-decoration:none;color:#bdbcbc;text-align:left">Hi {{first_name | there}}, your payment of {{amount_due}} for {{plan_name | your plan}} did not go through.</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 14px">
<table class="mt-table" role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-label" style="padding:11px 0;font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#787574;text-align:left">Reason</td>
<td class="mt-value" align="right" style="padding:11px 0;font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#16110f;text-align:right">{{failure_reason | The payment was not accepted}}</td>
</tr>
<tr>
<td class="mt-label mt-rule" style="padding:11px 0;border-top:1px solid #e5e5e5;font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#787574;text-align:left">Amount</td>
<td class="mt-value mt-rule" align="right" style="padding:11px 0;border-top:1px solid #e5e5e5;font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#16110f;text-align:right">{{amount_due}}</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 20px">
<table role="presentation" cellpadding="0" cellspacing="0" border="0" style="border-collapse:separate;">
<tr>
<td class="mt-btncell" align="center" bgcolor="#d4361f" style="background:#d4361f;border-radius:0px;">
<a class="mt-button" href="{{update_url}}" style="display:inline-block;padding:15px 28px;font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:14px;font-weight:800;line-height:100%;letter-spacing:0.6px;color:#ffffff;text-decoration:none;text-align:center;border-radius:0px">Update payment method</a>
</td>
</tr>
</table>
</td>
</tr>
{{#if retry_date}}
<tr>
<td class="mt-px" style="padding:0px 40px 18px">
<div class="mt-callout mt-co-warning" style="background:#fbf1dc;border-left:4px solid #b7791f;border-radius:0px;padding:15px 18px;font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:14px;line-height:155%;color:#5c3a05">
<p style="margin:0">We will try again on {{retry_date}}. Update your payment method before then to avoid any interruption.</p>
</div>
</td>
</tr>
{{/if}}
<tr>
<td class="mt-px" style="padding:14px 40px 0">
<div class="mt-rule" style="border-top:1px solid #e5e5e5;line-height:0;font-size:0;height:0">&nbsp;</div>
</td>
</tr>
<tr>
<td class="mt-px mt-footer" style="padding:16px 40px 34px;font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:12px;line-height:165%;color:#787574">{{footer_text | You are receiving this email because of your account.}}</td>
</tr>
</table>
</td>
</tr>
</table>
</body>
</html>
Plain text
{{app_name | Your app}}
​
Action needed
We could not take your payment
Hi {{first_name | there}}, your payment of {{amount_due}} for {{plan_name | your plan}} did not go through.
​
Reason: {{failure_reason | The payment was not accepted}}
Amount: {{amount_due}}
​
Update payment method: {{update_url}}
​
{{#if retry_date}}We will try again on {{retry_date}}. Update your payment method before then to avoid any interruption.{{/if}}
​
{{footer_text | You are receiving this email because of your account.}}

More templates

All email templates