Menu

Support

Home » Support » How to connect Contact Form 7 with Pronamic Pay

How to connect Contact Form 7 with Pronamic Pay

In this manual we describe how to use and configure Contact Form 7 with the Pronamic Pay plugin. A Basic license for Pronamic Pay is required to be able to download and install the Contact Form 7 add-on in your WordPress website.

Note: Do you already own a Basic license for Pronamic Pay? You then can download the Contact Form 7 add-on through your account on pronamic.eu.

Contact Form 7 payment form

Time needed: 10 minutes.

A step-by-step manual to add a payment method to Contact Form 7 with an existing payment configuration.

  1. Install and activate Contact Form 7 Add-On

    After you have download the Contact Form 7 Add-On you can install and activate the add-on on your WordPress website.

  2. Create a new Contact Form 7 form

    Go to ‘Contact’ in your WordPress dashboard and create a new form.

  3. Add form fields

    Add the form fields that are important for your form, such as name and address and other contact details.

  4. Create a price field

    Add a field to format the amount of the payment. This field can be a text, number, dropdown, check boxes or radio buttons field. Enter the values of the field with the price or pricing options to be charged.

  5. Give the new price field the pronamic_pay_amount option

    Add the option pronamic_pay_amount, within the field created in the previous step. See also example 1 below this step list.

  6. Add the pronamic_pay_method tag

    At the end of the form, above the submit field, add the pronamic_pay_method tag. Use the ‘payment method’ tag button at the top of the page. This tag shows a list of available payment methods of the gateway. See also example 2 below the steps.

  7. Add, optionally, the tag pronamic_pay_issuer

    Add the pronamic_pay_issuer tag above the submit field if you use the iDEAL payment method. Use the ‘Issuer’ tag button at the top of the page. This tag shows a selection list of issuers for payments via iDEAL. See also example 3 below this step list.

  8. Save the form

    Save the form, copy the shortcode generated at the top of the page and add it to the page on which you want to display the form.

Default payment gateway

After completing and submitting the form, the user is automatically redirected to the payment environment of the issuer. The default payment gateway is automatically used, as set in WordPress admin » Payment » Settings » Default Gateway.

Example tags

Sample Tag 1, a price field with options

The amount of an option can be indicated by using a vertical bar in the name|value format.

<label>Amount</label>
[radio radio-582 pronamic_pay_amount use_label_element free_text default:1 "Pay € 10,-|10" "Pay € 20,-|20" "Pay € 50,-|50" "Other"]

Sample Tag 2, payment methods

<label> Choose a payment method
    [pronamic_pay_method method] </label>

Sample Tag 3, list with iDEAL issuers

The [group group-name] … [/group] tag is possible thanks to the Contact Form 7 – Conditional Fields plugin, this plugin adds a ‘Conditional fields’ tab to the form editor to set the conditions.

[group pronamic_pay_issuer]
<label> Choose a issuer for iDEAL
    [pronamic_pay_issuer issuer] </label>
[/group]

Within the tab ‘Conditional fields’ select the pronamic_pay_issuer field, as a method this field must equal the value ideal.

Additional tag options

There are some additional options for tags to forward more information in a payment request. By inserting these options, the relevant data is sent and saved. On the basis of this data, all payments be better processed administratively and can be traced better to a relevant user later on.

  • pronamic_pay_amount
  • pronamic_pay_description
  • pronamic_pay_email
  • pronamic_pay_issuer
  • pronamic_pay_method

Name and address details

  • pronamic_pay_first_name
  • pronamic_pay_last_name
  • pronamic_pay_address_line_1
  • pronamic_pay_address_line_2
  • pronamic_pay_address_city
  • pronamic_pay_address_region
  • pronamic_pay_address_postal_code
  • pronamic_pay_address_country_code
  • pronamic_pay_address_company_name
  • pronamic_pay_address_coc_number

Billing information

  • pronamic_pay_billing_address_line_1
  • pronamic_pay_billing_address_line_2
  • pronamic_pay_billing_address_city
  • pronamic_pay_billing_address_region
  • pronamic_pay_billing_address_postal_code
  • pronamic_pay_billing_address_country_code
  • pronamic_pay_billing_address_company_name
  • pronamic_pay_billing_address_coc_number

Shipping information

  • pronamic_pay_shipping_address_line_1
  • pronamic_pay_shipping_address_line_2
  • pronamic_pay_shipping_address_city
  • pronamic_pay_shipping_address_region
  • pronamic_pay_shipping_address_postal_code
  • pronamic_pay_shipping_address_country_code
  • pronamic_pay_shipping_address_company_name
  • pronamic_pay_shipping_address_coc_number

Note: the pronamic_pay_address_* field is used for both the billing and shipping addresses, unless further specified with pronamic_pay_billing_address_* and pronamic_pay_shipping_address_*.

Postponing e-mail notifications

It is not (yet) possible to postpone the e-mail notifications after successfully processing a payment.

Last modified: 13 July 2020.