Configuring and Troubleshooting with

NOTE: This integration is available to MemberPress Pro users only.

Initial Setup Video Instructions

Detailed Instructions

To get started, navigate to the Settings menu in MemberPress and select payments.

  1. Click the (+) button and select a new gateway, ""
  2. You can name it whatever you like. However, this is the name your users will see when they select how to pay. Therefore, we recommend something like, "Pay with Credit Card".
  3. Go to your dashboard to obtain the necessary keys: API Login ID, Transaction Key, and Signature Key.
  4. In Account settings, select API Credentials & Keys under Security Settings.
  5. Copy and paste your API Login ID into the MemberPress settings.
  6. Copy and paste the Transaction Key into the MemberPress settings.
  7. Copy and paste the Signature Key into the MemberPress settings.
  8. Copy the Webhook URL from MemberPress, and paste it into > Account > Business Settings > Webhooks. Make sure its status is set to "Active" and that it's configured to send for All Events. You can name it whatever you'd like, but we recommend "MemberPress Webhook".
  9. Note: The Usernames field shown in the video above has been removed and is no longer needed as of MemberPress version 1.3.51.
  10. Run tests for both Recurring (ARB) subscriptions and Non-Recurring (AIM) subscriptions to ensure everything is working properly.

Use Sandbox mode only if you have a account. This will allow you to make sure everything works without charging any real cards. To get a Sandbox account, you'll first need to sign up at If you've been using Sandbox mode and you're going live, be sure to update your API Login ID, Transaction Key, Signature Key, and Webhook URL for your live account as mentioned above.

Use Force SSL if your site can be viewed in both http and https. Doing so will automatically switch to https when a user is going to pay so that the transaction is secure.

Back to the top Gateway Capabilities

  • Process One-Time Payments
  • Process Recurring Payments
  • Process Refunds
  • Change credit card for Recurring Subscription
  • Process Free/Paid Trial Periods
  • Credit card Expiring Reminders Supported

Back to the top

Canceling Subscriptions in

Normally, you'll want to cancel subscriptions directly in MemberPress as outlined here. However, you may need to cancel a subscription directly in your account. For example, this would be necessary if you deleted a subscription in MemberPress before correctly canceling it. In such cases, follow these instructions to cancel directly in

  1. Login to your account
  2. Click on Tools > Recurring Billing
  3. View active subscriptions
  4. Find the user's subscription in the list, and click on its Subscr ID link
  5. Click "Edit Subscription" at the top
  6. Click "Cancel Subscription" at the top
  7. Click "OK" on the pop-up to confirm the cancellation

Back to the top

Adding a Missing Payment

Follow these instructions if you see a completed payment in your account, but that payment is not reflected on the MemberPress > Transactions page and/or is not connected to its subscription on the MemberPress > Subscriptions page *

Please note that a missing payment is a sign that your integration has not been set up properly according to the instructions above. Please double and triple check your setup, and contact MemberPress Support if you continue having problems. 

If you see a Subscription ID on the MemberPress > Subscriptions page for the user, but it looks like mp-sub-xxxxxxxxxxx, you'll need to follow these instructions before proceeding to Step 1. 

Step 1 - Find the Transaction ID for the Payment in

To begin, you'll need to find the payment (if you are not already aware of it). Information you can use to search for it includes:

  • The subscription ID (if a recurring subscription) as it appears on the MemberPress > Subscriptions page (look for a string of numbers)
  • The user's email, which can be found on the WordPress > Users page OR the MemberPress > Members page
  • The date the billing occurred
With that information in hand, you can find the transaction ID in by doing the following (note: these steps come directly from an's support page; for the full page. please click here):
  1. Log into the Merchant Interface at
  2. Click Transaction Search from the main toolbar.
  3. Click Search for a Transaction in the main left side menu.
  4. Enter one or more search parameters in the fields provided.
  5. Click the Show drop-down to choose how many results per page to display:10 (default), 15, 20, or 25 results.
  6. Click Search to display your Transaction Summary. This will pull up your results:

Copy the Transaction ID you see under the  Trans ID column. You'll use this in Step 2.

Step 2 - Manually Add the Transaction

To manually add the missing payment, you can follow these steps based on the type of payment you received:

A Single One-Time Payment (NOT associated with an existing recurring subscription):
  1. Go to MemberPress > Transactions.
  2. Select Add new at the top of the page.
  3. Paste in the Transaction ID you identified in Step 1 into Transaction number.
  4. Select the user you'd like the transaction to be associated with. You can start typing in the username, and available options will pop up.
  5. Select which Membership the transaction should be associated with.
  6. Add the transaction Sub-Total amount. This should be what the user paid you.
  7. Add in any data related to taxes as applicable.
  8. Set the Status of the transaction to Complete.
  9. Set the Gateway to
  10. Leave the Subscription field blank.
  11. Add the Created Date. The date you set here will be the date when the user paid you.
  12. Add the Expiration Date. The date you set here will be the date the user's payment is set to expire.
  13. Select Create.
If you want to add a transaction to an existing recurring subscription:
  1. Go to MemberPress > Subscriptions.
  2. Search for the user's subscription you'd like to add the missing payment to.
  3. Hover over the subscription's unique ID and click on the "Add Txn" link.
  4. Paste in the Transaction ID you identified in Step 1 into Transaction number.
  5. Select the user you'd like the transaction to be associated with. You can start typing in the username, and available options will pop up.
  6. Select which Membership the transaction should be associated with.
  7. Add the transaction Sub-Total amount. This should be what the user paid you.
  8. Add in any data related to taxes as applicable.
  9. Set the Status of the transaction to Complete.
  10. Set the Gateway to
  11. Leave the Subscription field as is (it should have been auto-populated with the correct ID).
  12. Add the Created Date. The date you set here will be the date when the user paid you.
  13. Add the Expiration Date. The date you set here will be the date the user's payment is set to expire.
  14. Select Create.

Step 3 - Verify

After completing these steps, the payment should be correctly added, and the user's subscription should be marked active, as highlighted here ( Note: On the MemberPress > Subscription page, the Active column should be set to a green Yes and the Expires on column should reflect the missing payment's expiration date): 

Back to the top

Handling Failed Payments

If a member's payment fails and's Automatic Retry feature isn't enabled, then you will need to manually recharge the member's payment in If Automatic Retry is enabled, then the member's subscription will remain in a "suspended" state until they update the card tied to their subscription in MemberPress. Once updated, will automatically retry the failed payment for the subscription.'s Automatic Retry feature can be enabled by signing into your account and accessing the Recurring Billings page under the Tools section. From here, you'll want to click the "Enable Automatic Retry" link and click on the button, "Enable Automatic Retry".

NOTE:'s Automatic Retry can not be disabled once it's been activated in your account.

Back to the top

Troubleshooting Common Issues

Error "Email Required"

If you get an error that the Email field is required, edit your Payment Form settings in your account, and make sure "Email" is not a required field.

If you've done that, and you still get the error, your processor may require an email address. This custom snippet of code will help:

The above code can be pasted into a plugin like the WPCode plugin (please check this article for details: How to add custom code snippets in WPCode).

Error "The merchant login ID or password is invalid or the account is inactive"

If your customers are getting that error while trying to pay for a membership, and if the login ID and password are entered correctly, you'll need to check whether your account is in the Test (Sandbox) Mode. If it is, make it live.

Please refer to this tutorial or contact support.

Transaction Not Being Received After Recurring Subscription Signup

Recurring Subscriptions are billed through ARB at around 2 AM PST. As long as you've configured your integration as outlined in the setup instructions above, your transactions should come through sometime around or just after 2 AM PST. MemberPress validates the user's credit card before setting up the subscription, so payment failures are uncommon, though still possible.

Verify that your gateway is set up properly, then contact support if you continue to have trouble.

$1 Transaction Being VOIDed Immediately

When a user signs up for a Recurring membership, MemberPress does a $1 AUTH_ONLY transaction through AIM to verify that the credit card is good. The $1 AUTH_ONLY transaction is then voided, and the ARB subscription is created. The actual subscription payment should come through around 2 AM PST after ARB has processed it.

Back to the top

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.