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.
- 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.
- Create a new Contact Form 7 form
Go to ‘Contact’ in your WordPress dashboard and create a new form.
- Add form fields
Add the form fields that are important for your form, such as name and address and other contact details.
- 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.
- 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.
- 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.
- 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.
- 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.
Sample Tag 1, a price field with options
The amount of an option can be indicated by using a vertical bar in the
<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
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.
Name and address details
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.