🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!
Guides & Tutorials October 20, 2026

How to Accept iATS Donations With Gravity Forms

GravityExtra
How to Accept iATS Donations With Gravity Forms

Most donations start on a website, and most nonprofit websites run on WordPress. If your organisation processes gifts with iATS Payments, the last step is often the clumsy one: a form collects the details, and someone types the gift into iATS by hand, or donors are sent to a separate payment page and some of them never come back. Both cost money and goodwill.

This tutorial shows how to take iATS donations directly on a Gravity Forms form with the Gravity Forms iATS Payments Gateway Premium Add-on. We build the giving pages of a small community food share: a donation form with one-time and monthly gifts, a gala ticket form that also takes bank payments, and a family sponsorship with a welcome-pack fee. Along the way we cover test accounts, declined cards, ACH, refunds and how recurring gifts reach your entries.

A donation form for a community food share: how often to give with One time and Monthly, a gift amount of 25 dollars, name, email, phone and billing address, the total, and the payment details with a Pay by choice of Card or Bank account and the secure iATS payment form with card number, month and year, a line saying the card ending 4021 is ready and a note that payment details never reach or stay on the site
The iATS Payment field: the secure iATS form for a card or a bank account.

How an iATS Payment Works on Your Form

A few steps happen between the donor typing a card number and your thank-you message. Knowing them makes every setting easy to understand.

  1. The details go to iATS. The donor types the card or bank account into the secure iATS payment form inside your page. iATS checks it and sends the page a single-use cryptogram.
  2. The form goes to your site. Gravity Forms sends the form with the cryptogram instead of the card. Your server never sees the card or account number.
  3. The server takes the gift. While the form is validated, the add-on works out the amount from your pricing fields and uses the cryptogram once with the iATS REST API.
  4. The answer decides. Approved: the entry is saved as Paid. Declined: the donor sees a message on the form and can try another card. No entry is saved for a failed payment.

The cryptogram works once and only for 15 minutes, and the add-on never stores it. For recurring gifts the card or account is kept in the iATS vault, not on your site.

What You Need

  • WordPress with Gravity Forms 2.9 or newer, on a site with HTTPS.
  • An iATS Payments account on the 1stPay gateway. Ask iATS for a sandbox account to test with.
  • Your merchant key, processor ID and Transaction Center ID, and an ACH category if you want bank payments.
  • The add-on, installed and activated with your GravityExtra licence.

Step 1: Connect Your iATS Account

Go to Forms → Settings → iATS Payments, keep the mode on Test and paste your sandbox merchant key, processor ID and Transaction Center ID. When you save, the add-on asks iATS to confirm the details with a read-only query and shows a green line when they are accepted. The merchant key is stored encrypted and never printed back into the page. The processor ID and Transaction Center ID are public by design, because the browser needs them to load the secure form.

In the same screen, set the account currency, tick Bank account (ACH) if your account takes ACH, and enter the ACH category from your Transaction Center.

The iATS Payments settings page: mode Test or Live, the test environment with sandbox account or validation environment, the test merchant key saved encrypted, the processor ID, Transaction Center ID and ACH processor ID, empty live fields, a green line saying the merchant key and processor ID were accepted by iATS, the account currency, the bank account option, the ACH category, the payment form language and the webhook address
Forms → Settings → iATS Payments: account per mode, check, ACH and webhooks.

Step 2: Build the Donation Form

Our food share wants one form for every gift. It starts with a choice: How often would you like to give? with One time and Monthly. Then comes a Gift amount field, a Product field with a user-defined price, so donors type any amount. Add Name, Email, Phone and Address fields, a Total field, and finally the iATS Payment field from the Pricing Fields group.

On the live form the iATS Payment field shows a Pay by choice between Card and Bank account, and the secure iATS form below it. When the details are complete, a short line confirms, for example, that the card ending 4021 is ready. If the donor clicks the button too early, the form asks for the payment details first.

Step 3: Two Feeds, One Form

Open the form’s Settings → iATS Payments and add two feeds. The first uses Products and Services with the condition How often is One time. The second uses Subscription with the condition How often is Monthly, the form total as the recurring amount and a billing cycle of one month. Map the billing fields in both: iATS needs the name and the full billing address for online payments.

Gravity Forms runs the feed that matches the donor’s choice. The add-on notices that the form can start a monthly gift and asks iATS for a vault-ready cryptogram, so the same secure form works for both. A one-time card gift is charged and its vault record deleted at once; a monthly gift keeps it.

Step 4: Test Gifts, Declines and Errors

Open the form and give with one of the test card numbers in the iATS sandbox documentation and any future expiry date. With a sandbox account no real card is charged. You see your confirmation, and the entry shows the status Paid, the iATS reference number, the card type and the last four digits. The add-on reads every card payment back from iATS and checks the amount before it trusts it.

Then test the paths that go wrong. The sandbox has cards that are always declined: the donor sees a clear message on the payment field and no entry is saved, so your entry list only contains real gifts. If iATS cannot be reached at all, the donor is told that nothing was charged.

A Gravity Forms entry for a Harvest Gala dinner ticket of 120 dollars paid by card: the notes say the payment was approved through the secure payment form with a Visa card ending in 4021, and on the right the iATS Payments box shows status Paid, one-time payment, the card, the amount, the reference and the order id, a refund amount with a Refund button and a Void payment button
The entry screen: payment notes and the iATS Payments box with Refund and Void.

Step 5: Monthly Gifts From the Vault

When a donor chooses Monthly, the add-on stores the card or bank account in a new iATS vault, charges the first gift from it and saves the entry as Active with the date of the next payment. Twice a day it charges every gift that is due. Each payment has its own order id, and iATS refuses an order id it has already seen, so a donor is never charged twice, even if a connection drops at the wrong moment.

For the family sponsorship we use a monthly amount of 60 dollars, twelve payments and a welcome-pack setup fee of 15 dollars. The first payment is 75 dollars; the next eleven are 60 dollars on the same day of each month. A free first month works too: turn on the trial with an amount of zero, and the first charge happens one month later.

If a monthly payment is declined, the entry notes it and the payment is tried again the next day. After three tries the gift stops and you get a clear note to contact the donor. Cancelling in Gravity Forms stops the payments and deletes the vault at iATS.

Step 6: Gifts From a Bank Account

Many donors prefer to give from their bank account, and ACH fees are usually lower. When the donor chooses Bank account, the secure iATS form asks for the name on the account, the routing number, the account number and the account type. iATS accepts the debit as Pending; it posts in the daily run, and the bank can still return it days later.

The add-on keeps the entry Pending and checks the debit twice a day. When iATS posts it, the entry becomes Paid. When the bank returns it, the entry becomes Failed with the return reason, and a monthly gift whose first debit came back is stopped. For instant updates, add the add-on’s webhook address in the iATS WebHooks Control Center with the ach.reject event.

Step 7: Refunds, Voids and Thank-you Messages

Open the entry and use the iATS Payments box. Before the batch settles, usually on the same day, Void payment cancels a card gift completely. After settlement, Refund returns all or part of it. A pending bank payment can be cancelled with Cancel ACH debit. Every button asks for confirmation and uses a one-time request id, so a double click never refunds twice.

For receipts, send a notification on the Payment Completed or Recurring Gift Created event and use merge tags such as {entry:payment_amount} and {entry:transaction_id}. Your team can get a note on Recurring Payment Failed to follow up with the donor.

Step 8: Go Live

When test gifts, declines, a refund and a bank payment all work, fill in the live merchant key, processor ID and Transaction Center ID, switch the mode to Live and save. Make one small real gift and refund it to be sure. Entries paid in Test mode keep refunding against the test account.

Tips for Donation Forms

  • Make monthly easy. Put the One time / Monthly choice first, so donors see it before they pick an amount.
  • Say what happens next. A line such as “25 dollars today and on the 20th of each month” prevents surprised e-mails.
  • Offer bank payments. Some donors prefer to give from their bank account, and ACH fees are usually lower.
  • Thank donors fast. Send the receipt on the payment events, not on form submission, so only successful gifts get a thank-you.

Frequently Asked Questions

Is card or bank data stored on my site?

No. The details are typed into the secure iATS form and replaced by a single-use cryptogram before the form is sent. The add-on stores the reference number, the card type or account type and the last four digits only.

Does it work with Canadian dollars?

Yes. Set the account currency to CAD when your iATS processing account is in Canadian dollars, and use CAD in Gravity Forms.

Can donors change their monthly amount?

Version 1.0 charges the amount chosen on the form. To change it, cancel the gift and ask the donor to give again with the new amount.

Which Gravity Forms version do I need?

Gravity Forms 2.9 or newer, any licence, with WordPress 6.5 and PHP 7.4 or newer.

Take iATS Donations in Gravity Forms

Secure iATS payment form, card and ACH, one-time and recurring gifts, refunds and ACH status, all inside Gravity Forms.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr