...
The tags below are all of those available for this email template. For other email and tag customizations, see Customizing Emails.
Tag | Description | Notes | Since Version |
---|
{contact.first_name} | The client's first name | |
|
{contact.last_name} | The client's last name | |
|
{contact.email} | The client's email address | |
|
{contact.id_code} | The client's ID | e.g. 1500 |
|
{autodebit} | Whether or not autodebit is enabled for this client | i.e. 1 or 0, denoting yes or no, respectively |
|
{client_url} | The URI to Blesta's client interface | e.g. domain.com/billing/client/ |
|
{payment_account.first_name} | The first name on the payment account assigned for autodebit |
| v4.4.0 |
{payment_account.last_name} | The last name on the payment account assigned for autodebit |
| v4.4.0 |
{payment_account.account_type} | The payment account type that is assigned for autodebit | i.e. "cc" or "ach" | v4.4.0 |
{payment_account.last4} | The last four digits on the payment account assigned for autodebit |
| v4.4.0 |
Expand |
---|
|
Due to the nature of tag objects containing several fields, many of which are likely irrelevant for use in email templates, but may be useful to you in certain circumstances, an example dump of the tag objects are shown below. Code Block |
---|
language | php |
---|
title | The {contact} object |
---|
collapse | true |
---|
| stdClass Object
(
[id] => 1
[client_id] => 1
[user_id] =>
[contact_type] => primary
[contact_type_id] =>
[first_name] => First
[last_name] => Last
[title] =>
[company] => Company Co.
[email] => first.last@domain.com
[address1] => 123 Main St.
[address2] =>
[city] => City
[state] => CA
[zip] => 90001
[country] => stdClass Object |
|
Expand |
---|
|
Due to the nature of tag objects containing several fields, many of which are likely irrelevant for use in email templates, but may be useful to you in certain circumstances, an example dump of the tag objects are shown below. Code Block |
---|
language | php |
---|
title | The {contact} object |
---|
collapse | true |
---|
| stdClass Object
(
[id] => 1
[client_id] => 1
[user_id] =>
[contact_type] => primary
[contact_type_id] =>
[first_name] => First
[last_name] => Last
[title] =>
[company] => Company Co.
[email] => first.last@domain.com
[address1] => 123 Main St.
[address2] =>
[city] => City
[state] => CA
[zip] => 90001
[country] => stdClass Object
(
[alpha2] => US
[alpha3] => USA
[name] => United States
[alt_name] =>
)(
[date_added [alpha2] => 2014-05-08 21:35:13
US
[contact_type_namealpha3] => USA
[contact_type_is_lang] =>
) | Code Block |
---|
language | php |
---|
title | The {invoices} array of objects |
---|
collapse | true |
---|
| Array (
[0name] => stdClass Object
(United States
[idalt_name] => 505
)
[iddate_formatadded] => {num} 2014-05-08 21:35:13
[contact_type_name] =>
[id_valuecontact_type_is_lang] =>
) |
Code Block |
---|
language | php |
---|
title | The {invoices} array of objects |
---|
collapse | true |
---|
| Array (
171
[0] => stdClass Object
[client_id] => 1(
[date_billedid] => 2014-09-18 07:00:00505
[dateid_dueformat] => 2014-09-23 07:00:00{num}
[dateid_closedvalue] => 171
[dateclient_autodebitid] => 1
[statusdate_billed] => active 2014-09-18 07:00:00
[subtotaldate_due] => 1.0000 2014-09-23 07:00:00
[totaldate_closed] => 1.0000
[paiddate_autodebit] => 0.0000
[previous_duestatus] => 829.5010
active
[currencysubtotal] => USD1.0000
[note_publictotal] => 1.0000
[note_privatepaid] => 0.0000
[idprevious_codedue] => 171829.5010
[delivery_date_sentcurrency] => USD
[duenote_public] => 1.0000
[linenote_itemsprivate] => Array
[id_code] => (
171
[0[delivery_date_sent] => stdClass Object
[due] => 1.0000
( [line_items] => Array
(
[id] => 1181
[0] => stdClass Object
[invoice_id] => 505(
[service_id] => 1181
[descriptioninvoice_id] => Line Item Description505
[qtyservice_id] => 1.0000
[amountdescription] => 1.0000 Line Item Description
[subtotalqty] => 1.0000
[amount] => 1.0000
[subtotal] => 1.00000000
[taxes] => Array
(
)
[taxes_applied] => Array
(
)
[tax_subtotal] => 0
[tax_total] => 0
[total] => 1
[total_w_tax] => 1
)
)
[delivery] => Array
(
[0] => stdClass Object
(
[id] => 510
[invoice_id] => 505
[method] => email
[date_sent] =>
)
)
[meta] => Array
(
)
[tax_subtotal] => 0
[tax_total] => 0
[taxes] => Array
(
)
[billing] => stdClass Object
(
[id] => 1
[client_id] => 1
[user_id] =>
[contact_type] => primary
[contact_type_id] =>
[first_name] => First
[last_name] => Last
[title] =>
[company] => Company Co.
[email] => first.last@domain.com
[address1] => 123 Main St.
[address2] =>
[city] => City
[state] => CA
[zip] => 90001
[country] => stdClass Object
(
[alpha2] => US
[alpha3] => USA
[name] => United States
[alt_name] =>
)
[date_added] => 2014-05-08 21:35:13
[contact_type_name] =>
[contact_type_is_lang] =>
)
[client] => stdClass Object
(
[id] => 1
[id_format] => {num}
[id_value] => 1500
[user_id] => 2
[client_group_id] => 1
[primary_account_id] =>
[primary_account_type] =>
[status] => active
[id_code] => 1500
[contact_id] => 1
[first_name] => First
[last_name] => Last
[company] => Company Co.
[email] => first.last@domain.com
[address1] => 123 Main St.
[address2] =>
[city] => City
[state] => CA
[zip] => 90001
[country] => US
[group_name] => General
[company_id] => 1
[username] => first.last@domain.com
[two_factor_mode] => none
[two_factor_key] =>
[two_factor_pin] =>
[date_added] => 2014-05-08 21:35:13
[settings] => Array
(
...
[language] => en_us
...
)
)
[applied_transactions] => Array
(
)
[payment_url] => domain.com/billing/client/pay/method/505/?sid=c6V8FU5X%2BdGtT9nZQ5DVOO2SsZdc5hC9k1ct6AiLtBs%3D
[autodebit_date] => 2014-09-22 07:00:00
[autodebit_date_formatted] => Sep 22, 2014
)
) |
Code Block |
---|
language | text |
---|
title | {payment_account} |
---|
collapse | true |
---|
| A credit card payment account:
stdClass Object
(
[id] => 4
[contact_id] => 1
[first_name] => First
[last_name] => Last
[address1] => 123 Main St.
[address2] =>
[city] => City
[state] => CA
[zip] => 90001
[country] => US
[number] => d6/No/zCxnjXmcAPxxRvpTm4a84+MiM6IepKj79Nh1gxmDplUl9Gz6ehFLiCjOhDZgGGRHmEx1Z7DRiy+Y97tuAnMi3nEAZppTI4Qs3f8BSZdKWjfGsXiYr9F0miUJ8Ret9/3F+o980q2vQ3SPBIGWk18f0AflMe3R1mapP3IZcrijVpcTYfI1Z99eNmXwcZ5TmeAyqd9+Sj7lbkf2yWtBonMogvrcclH9DhCORW7hQjm2jYFZQT74M6UWT990aOI/yghQVACWWho217vkWB+nwjmBsVbB5QgY/X29BFmjUpmqw73Qi2h/TpYlG3zCFFDrmRyCPy+CjCNWiWxLd/fCd9MR7dXEzEzN/vg3d35nfbM+71vTDRe4SDn4Q9VjQhI7rwDYMlhQ5f7U7HeTt9m/l5ggB7rg//iYoOtTYo+OncN0+qnQ99dQ5pZWatenXfZAhPVDS3eLNdQxZhKpcd2OyU/DjpFEYIA0dytWzbEMWoUO7/rKUv6LvbEpx3M57b
[expiration] => 202105
[last4] => 1234
[type] => mc
[gateway_id] =>
[client_reference_id] =>
[reference_id] =>
[status] => active
[client_id] => 1
[type_name] => Master Card
[account_type] => cc
)
An ACH payment account:
stdClass Object
(
[id] => 2
[contact_id] => 1
[first_name] => First
[last_name] => Last
[address1] => 123 Main St.
[address2] =>
[city] => City
[state] => CA
[zip] => 90001
[country] => US
[account] => m6gfz+Ee2SUldJIiBntBfbdnpLSsosZs7GVgpG24N1+IAqjl57RuxnsZU+COFBlwP26r8TzUmiINRrlh6EhsdzTiiFYHtdF1KT4Ht+UYlp7giLKW8tIYF05Xtt5Q+yNIj6zViYGV/6ZjZWNanfIwafwfcrHfqjBFyuY5a+mjOsf1/eW0lc2RyFIMwNFh8uSUM++bTfUEBSxKnEwSb8yQhrrD35CjNlmHn30Hql45nJkPFQEsbUOlNxeiOo/IAwj+J8X3Zc3WKQrFHD/F92XtRpHeYCyRSVF9QaK71qgeyly/H1xdVOGI2bYYgy7ARV071AXXACSOMHAlp88X1BR5Q0wWjspTeBjRN0fDE5UEjKMaLPa777Bcz5BmlmgGm63A994nPl5xK+DDx+e4c54zOJY7gDR/AUnlumAYZ0Dp4XmFRY3uI5qPQ9Iucpui9cWxH4ItC/Jyh0f2gw93qG3EKQAxY/0YMeRKkDlCqo1spdTvU0YowSz6qmJRm57EhugW
[routing] => e+p5fZGqTYiFzUcM1eHJo15j/lCnuKKPn6aHYy9Sj1/P4kCawX8AUxAJYUp4jGUzuKUuDV+N5P9tQUb85DIeCPrFqb11lRCe6sSjjEbDxNXlgGoILNzx/OZdcqXo5oUqd8Rt/dLpdLrwUPyNOpTQi7xaOh+APiCk5B3rFE7wq4nPjzl+OvQXp28IkN7ehw1ZOnFj8EoTGFDVfNIspYd6IqLiopDOvO2iDesga6YLbnCBJQ/rVMwCF6/jGpgtXMH1YbMq0qNO8jIjrxudFmIF9TaAPxV4UpQ2adl2u5O6iKhqRYeKxpyylZk07CeqI3PZOVHzdHGvo2AILzfA3BJUtzuYCW4nGVNUwfEaUxE12PHUE7GThdkucBtnOBhJBIQlmr6OEwPLYXa7163slmHUQ/wWLPJNfm09eux32KZhxXx1F+oZo4K+nVXQMaZJQPctKUhvcl8Ssb4i+aVOH/Ei7ga+5kuWT+d7Pzycyi5mGp/K+Y9ZiI/wiwstAtJJSwZH
[last4] => 1112
[type] => checking
[gateway_id] =>
[client_reference_id] =>
[reference_id] =>
[status] => active
[client_id] => 1
[type_name] => Checking
[account_type] => ach
) |
|
Payment Links
This email template includes invoice payment links that you can make available in the email to allow customers to pay an invoice without having to login to their client account. Each invoice available in the {invoices} tag includes a payment_url field that uniquely identifies the invoice to be paid. You can iterate over each invoice in the template to set the link. Consider the following example where invoice information is set, encapsulated in a for loop:
Code Block |
---|
|
{% for invoice in invoices %}
Invoice ID: {invoice.id_code}
Amount Due: {invoice.due}
Pay now at https://{invoice.payment_url}.
{% endfor [username] => first.last@domain.com
[two_factor_mode] => none
[two_factor_key] =>
[two_factor_pin] =>
[date_added] => 2014-05-08 21:35:13
[settings] => Array
(
...
[language] => en_us
...
)
)
[applied_transactions] => Array
(
)
[payment_url] => domain.com/billing/client/pay/method/505/?sid=c6V8FU5X%2BdGtT9nZQ5DVOO2SsZdc5hC9k1ct6AiLtBs%3D
[autodebit_date] => 2014-09-22 07:00:00
[autodebit_date_formatted] => Sep 22, 2014
)
) |
Payment Links
This email template includes invoice payment links that you can make available in the email to allow customers to pay an invoice without having to login to their client account. Each invoice available in the {invoices} tag includes a payment_url field that uniquely identifies the invoice to be paid. You can iterate over each invoice in the template to set the link. Consider the following example where invoice information is set, encapsulated in a for loop:
Original Email
Code Block |
---|
language | xml |
---|
title | HTML (version 4.4.0+) |
---|
collapse | true |
---|
|
<p>Hi {contact.first_name},<br />
<br />
An invoice has been created for your account and is attached to this email in PDF format.<br />
{% for invoice in invoices %}<br />
Invoice #:<strong> {invoice.id_code}</strong></p>
<p>{% if autodebit %}{% if payment_account %}{% if invoice.autodebit_date_formatted %}Auto debit is enabled for your account, so we'll automatically process the card you have on file on <strong>{invoice.autodebit_date_formatted}</strong> unless payment has been applied sooner.{% else %}If you would like us to automatically charge your card, login to your account at <a href="http://{client_url}">http://{client_url}</a> to set up auto debit.{% endif %}{% else %}If you would like us to automatically charge your card, login to your account at <a href="http://{client_url}">http://{client_url}</a> to set up auto debit.{% endif %}{% else %}If you would like us to automatically charge your card, login to your account at <a href="http://{client_url}">http://{client_url}</a> to set up auto debit.{% endif %}<br />
<br />
<a href="http://{invoice.payment_url}">Pay Now</a> (No login required)<br />
{% endfor %}<br />
If you have any questions about your invoice, please let us know!</p>
|
Code Block |
---|
language | xml |
---|
title | Text (version 4.4.0+) |
---|
collapse | true |
---|
|
Hi {contact.first_name},
An invoice has been created for your account and is attached to this email in PDF format.
{% for invoice in invoices %}
Invoice #: {invoice.id_code}
{% if autodebit %}{% if invoice.autodebit_date_formatted %}Auto debit is enabled for your account, so we'll automatically process the card you have on file on {invoice.autodebit_date_formatted} unless payment has been applied sooner.{% else %}If you would like us to automatically charge your card, login to your account at http://{client_url} to set up auto debit.{% endif %}{% else %}If you would like us to automatically charge your card, login to your account at http://{client_url} to set up auto debit.{% endif %}{% if autodebit %}{% if payment_account %}{% if invoice.autodebit_date_formatted %}Auto debit is enabled for your account, so we'll automatically process the card you have on file on {invoice.autodebit_date_formatted} unless payment has been applied sooner.{% else %}If you would like us to automatically charge your card, login to your account at http://{client_url} to set up auto debit.{% endif %}{% else %}If you would like us to automatically charge your card, login to your account at http://{client_url} to set up auto debit.{% endif %}{% else %}If you would like us to automatically charge your card, login to your account at http://{client_url} to set up auto debit.{% endif %}
Pay Now, visit http |
Code Block |
---|
|
{% for invoice in invoices %}
Invoice ID: {invoice.id_code}
Amount Due: {invoice.due}
Pay now at https://{invoice.payment_url}. (No login required)
{% endfor %} |
Original Email
If you have any questions about your invoice, please let us know! |
Code Block |
---|
language | xml |
---|
title | HTML (version 3.0.0 up to 4.3.x) |
---|
collapse | true |
---|
|
<p>Hi {contact.first_name},<br />
<br />
An invoice has been created for your account and is attached to this email in PDF format.<br />
{% for invoice in invoices %}<br />
Invoice #:<strong> {invoice.id_code}</strong></p>
<p>{% if autodebit %}{% if invoice.autodebit_date_formatted %}Auto debit is enabled for your account, so we'll automatically process the card you have on file on <strong>{invoice.autodebit_date_formatted}</strong> unless payment has been applied sooner.{% else %}If you would like us to automatically charge your card, login to your account at <a href="http://{client_url}">http://{client_url}</a> to set up auto debit.{% endif %}{% else %}If you would like us to automatically charge your card, login to your account at <a href="http://{client_url}">http://{client_url}</a> to set up auto debit.{% endif %}<br />
<br />
<a href="http://{invoice.payment_url}">Pay Now</a> (No login required)<br />
{% endfor %}<br />
If you have any questions about your invoice, please let us know!</p>
|
Code Block |
---|
language | xml |
---|
title | Text (version 3.0.0 up to v4.3.x) |
---|
collapse | true |
---|
|
Hi {contact.first_name},
An invoice has been created for your account and is attached to this email in PDF format.
{% for invoice in invoices %}
Invoice #: {invoice.id_code}
{% if autodebit %}{% if invoice.autodebit_date_formatted %}Auto debit is enabled for your account, so we'll automatically process the card you have on file on {invoice.autodebit_date_formatted} unless payment has been applied sooner.{% else %}If you would like us to automatically charge your card, login to your account at http://{client_url} to set up auto debit.{% endif %}{% else %}If you would like us to automatically charge your card, login to your account at http://{client_url} to set up auto debit.{% endif %}
Pay Now, visit http://{invoice.payment_url} (No login required)
{% endfor %}
If you have any questions about your invoice, please let us know! |
...