Tyl for Gravity Forms
Tyl for Gravity Forms - Quick Setup Guide
Tyl for Gravity Forms lets you take card payments through an existing Gravity Forms form by sending customers to Tyl’s secure hosted payment page after they submit the form.
Card details are entered on Tyl’s hosted checkout, not on your WordPress website.
1. Before you start
You will need:
- WordPress with Gravity Forms installed and active
- A Tyl online payments account
- Your Tyl Store ID
-
Your Tyl Shared Secret
A Gravity Form with either:
- Gravity Forms Product/Total fields, or
- a field containing the payment amount
2. Add your Tyl credentials
In WordPress, go to:
Forms > Settings > Tyl for Gravity Forms
Choose whether you are using Test Mode or Live Mode, then enter the relevant Tyl details:
- Store ID
- Shared Secret
Use Test Mode first so you can check the payment journey without taking real payments.
3. Add Tyl to an existing form
Go to:
Forms > Forms
Open the form you want to take payment from, then go to:
Settings > Tyl for Gravity Forms
Create a new Tyl feed and enable Tyl payments for the form.
Only one Tyl payment feed can be used per form.
4. Choose the payment amount
In the Tyl feed settings, choose where the payment amount should come from.
You can use either:
Gravity Forms Total
Use this if your form already uses Gravity Forms Product, Option, Quantity or Total fields.
Custom mapped field
Use this if your form already has a field containing the amount to charge.
The amount must be a valid GBP amount, for example:
- 10.00
- 25.50
- 100.00
Do not include a pound sign or commas.
5. Add success and failure pages
In the feed settings, enter:
Success URL
The page customers should return to after a successful payment.
Failure URL
The page customers should return to if the payment is declined, cancelled or unsuccessful.
You may want to create simple WordPress pages such as:
- Payment successful
- Payment not completed
6. Map customer fields
Map any customer details you want to send to Tyl, such as:
- Name
- Email address
- Phone number
- Billing address
Only map fields that already exist on your form. If you do not need to send billing details, you can leave these unmapped.
7. Choose when notifications are sent
The plugin lets you choose when Gravity Forms notifications are sent.
Options:
On form submission
Send notifications as soon as the form is submitted, even before payment is completed.
On successful payment
Only send notifications once Tyl confirms the payment was successful.
Both
Send one notification when the form is submitted, and another when payment is confirmed.
For most enquiry/payment forms, “Both” is often the most useful option.
8. Save and test the form
Save the Tyl feed, then view the form on the front end of your website.
Submit the form using a test amount. You should be redirected to the Tyl hosted payment page.
After the payment attempt, check the Gravity Forms entry. The payment status should show as one of the following:
- Pending Payment
- Paid
- Failed / Unpaid
- Abandoned
If a customer starts payment but does not complete it, the entry will remain in Gravity Forms and will be marked as abandoned after 1 hour.
9. Tyl test card details
Only use these card details in Test Mode. They must not be used in Live Mode.
Visa test card
Card number:
4035874000424977
Expiry date:
Any future date
Security code:
Any three digits
Verified by Visa password:
Secret!33
Mastercard test card
Card number:
5426064000424979
Expiry date:
Any future date
Security code:
Any three digits
SecureCode password:
Secret!33
If the 3D Secure screen appears during testing, enter the password above. To test an unsuccessful authentication, use the cancel option on the 3D Secure screen.
10. Going live
When testing is complete:
- Change the plugin from Test Mode to Live Mode.
- Check your success and failure pages.
- Submit a small live test payment if appropriate.
- Confirm the Gravity Forms entry is marked as Paid.
- Confirm the transaction appears correctly in your Tyl account.
Do not switch to Live Mode until your test payments are working as expected.