• WPForms

Gateway Wizard with USAePay for WPForms

Accept credit and debit cards in WPForms with your USAePay merchant account.

  • Full card numbers go straight to USAePay and never touch your server.

Get Pro

PRO
How many sites?
Buy Pro · $79 a year

Renews yearly. Cancel any time. Priority email support included.

Take credit and debit card payments in WPForms with your USAePay merchant account.

Customers type their card into secure fields served by USAePay (Pay.js). The card number goes straight to USAePay and comes back as a one-time payment key, so it never reaches your server. That keeps your PCI compliance work small, instead of the long SAQ D questionnaire that comes with forms that post card numbers to your site.

It adds a card field to the WPForms form builder, records each payment in WPForms > Payments, and works with the free WPForms Lite.

What you get with USAePay

  • PRO

    Subscriptions

    Charge a form's total again every day, week, month, quarter or year, a set number of times or until you cancel. The card is stored in USAePay's vault, so nothing sensitive is stored on your site.

  • PRO

    Priority email support

    Help from the people who build the plugin, including a check of your gateway setup.

  • Card fields hosted by your gateway

    Full card numbers go straight to USAePay and never touch your server.

  • Payments recorded in WPForms

    Each payment appears under WPForms > Payments with its card type, last four digits and USAePay transaction ID.

  • Full and partial refunds

    Refund from the payment's WPForms screen, or from a refund box that also refunds part of a payment. Unsettled charges are voided automatically.

  • Choose accepted card brands

    Show only the card brands your merchant account takes.

  • Gateway email receipts

    Have USAePay send its own receipt to customers.

  • Safe debug log

    Keys and card data are removed before anything is logged.

  • 10+ USAePay-based providers

    Choose your merchant services company from the list, or paste your gateway login address.

Setup

  1. Install and activate the plugin.
  2. Go to WPForms > USAePay and paste in your API key and its PIN. Choose whether to charge right away or authorize only, then save.
  3. Edit a form. Add a payment field that has an amount (such as Single Item), and add the USAePay card field from the Payment Fields group.
  4. Open the form’s Payments tab, choose USAePay and turn on “Take payments with USAePay”.
  5. Submit the form to test. A sandbox account is the easiest way to test: check “Sandbox account” if you log in at sandbox.usaepay.com.

What you need

  • A merchant account with USAePay.
  • An API key and its PIN from your USAePay account, under Settings > API Keys.
  • WPForms 2.0 or newer (the free WPForms Lite is enough) and PHP 8.1 or newer.

Questions

Where do I find my API key and PIN?

Log in to your USAePay account and open Settings > API Keys. Create a key, set a PIN for it and copy both into the plugin’s settings. The plugin signs in with the key and PIN only, never your account username and password.

Can I test without charging a real card?

Yes. With a sandbox account, check “Sandbox account” and use USAePay’s test card numbers.

Do card numbers touch my server?

No. Full card numbers and security codes go from the shopper’s browser straight to USAePay. Your site receives a one-time token, the card type, the expiry date and a masked number (first six and last four digits). It keeps only the last four digits with each order, for refunds and order records. With Pro’s saved cards, it also keeps the card type and expiry, while the card itself is stored at USAePay.

How do refunds work?

Open the payment under WPForms > Payments and use its Refund button, or use the refund box under WPForms > USAePay, which can also refund part of a payment. A charge that has not settled yet can only be voided, so a full refund of an unsettled charge is sent as a void automatically.

My gateway gave me a different web address. Can I use it?

Yes. Many payment companies run on the same platform under their own name. Choose yours under Merchant account provider, or enter the address they gave you under Gateway address.

Can I use it with other WPForms payment methods?

WPForms takes one payment method per form. Turn on only one in each form’s Payments tab. Forms that use Stripe, Square or PayPal are not affected.

Can I take recurring payments?

Yes. This plugin charges each renewal automatically with the card saved at USAePay.

Need a merchant account?

Easy Pay Direct sets up merchant accounts for online stores, and their team handles approval and setup.

Some "apply for an account" links on this site are referral links. Gateway Wizard may be paid a referral fee if you open an account through one. It costs you nothing extra.

Ready to take USAePay payments on your store?

Pro starts at $79 a year for one site. If you ever stop renewing, your checkout keeps working.

Buy Pro