1. Home
  2. Functionality
  3. How to Configure the Payment Confirmation Display

How to Configure the Payment Confirmation Display

To configure what’s displayed to your customers or donors after a successful payment, go to WP Simple Pay → Settings → Payment Confirmation  → One-Time Payment. Here you can change what’s displayed for a successful One-Time Payment.

If you have the Plus license or higher, you’ll see two more tabs next to One-Time Payment: Subscription and Subscription with Trial. Here you can customize an alternate message for each of these as they all describe different types of payments.

Note that you’re customizing the payment confirmation page, not the receipts sent by email. View how to configure email receipts in Stripe.

Built-In Template Tag Reference

Here are the available template tags that come “built-in” that you can use to customize the payment confirmation messages:

{form-description}The form's Item Description value.
{form-titleThe form's item Title value.
{total-amount}The total price of the payment.
{charge-date}The charge date returned from Stripe.
{charge-id}The unique charge ID returned from Stripe.
{tax-amount}The calculated tax amount based on the total and the tax percent setting.
{recurring-amount}The recurring amount to be charged each period of the subscription. Applies to subscriptions without trials only.
{max-charges}The max number of charges until the subscription ends if installment plans are setup. Applies to subscriptions without trials only.
{trial-end-date}The day the plan's free trial ends. Applies to subscriptions with trials only.

Custom Template Tag for One Time Payments

To output additional information related to a one time payment use the {payment:key}, and {customer:key} template tags to access Stripe object data.

For example:

{payment:currency}
{customer:name}
{customer:address:city}

You can view the list of available object properties here:

https://stripe.com/docs/api/payment_intents/object
https://stripe.com/docs/api/customers/object

Custom Template Tags For Subscriptions

To output additional information related to a subscription payment use the {subscription:key}, and {customer:key} template tags to access Stripe object data.

For example:

{subscription:latest_invoice:number}
{customer:name}
{customer:address:city}

You can view the list of available object properties here:

https://stripe.com/docs/api/subscriptions/object
https://stripe.com/docs/api/customers/object

Using these custom template tags, you can create more personal and flexible payment confirmation pages, such as:

Which will display something like this on the Payment Confirmation page:

Make sure the [simpay_payment_receipt] shortcode resides on the Payment Success Page you designate if modified or changed (it should exist by default).

Including Custom Form Fields Data

Depending on the payment type, you’ll use one of the template tags below:

For one time payments:
{payment:metadata:Stripe Metadata Label}

For subscription payments:
{subscription:metadata:Stripe Metadata Label}

See the example below:

For one time payments:
{payment:metadata:invoice_entered}

For subscription payments:
{subscription:metadata:invoice_entered}

The above template tags can be use on confirmation pages, all emails, etc.

Was this article helpful?

Still stuck? How can we help?
Updated on June 23, 2022