Faster, Smoother New Version of ARMember7.0Launched Buy Now

Documentation

Configure ARMember Square Payment Gateway


Square Payment Gateway

Overview

Integrate the Square Payment Gateway with your ARMember-powered membership website to accept secure online payments with ease. This add-on allows you to connect your Square account with ARMember and enable seamless membership plan payments directly from your signup pages. In this guide, you will learn how to install and activate the ARMember Square Payment Gateway add-on, configure your Square account credentials, set up the required callback URL, and enable Square payments for your membership plans. Follow the step-by-step instructions below to complete the integration successfully.


Steps For Installation And Activation

square addon activate

You can install plugins in the following two ways. and the ARMember Square payment gateway plugin requires the ARMember plugin installed and active.

New install via FTP

  1. Download the plugin and extract it. You will find a directory armembersquare.
  2. In your WordPress installation directory, upload armembersquare to wp-content/plugins/
  3. Activate the ARMember - Square payment gateway plugin through the Plugins menu from the WordPress admin panel.

New install via the WordPress Uploader

  1. Download the plugin.
  2. Log in to your WordPress admin panel
  3. Go to PluginsAdd NewUpload
  4. Click on “choose file” and browse the download package. When the plugin uploads successfully, click on Activate Plugin.

You can also find this plugin from ARMember ⇾ Add-ons. When this plugin get activated to your site, you will get an additional option in ARMember ⇾ General Settings ⇾ Payment Gateways.


Choose Currency

The very first step is to select your desired currency of choice. To set the currency, navigate to the ARMemberGeneral Settings page, and here check the option for default currency and select the currency that works for you. ARMember provides a wide range of currencies to choose from; however, if you feel like adding your desired currency, then you can add the custom currency too.


ARMember Square Addon Supported Currencies

  1. Australian dollar: AUD
  2. Brazilian real: BRL
  3. Canadian dollar: CAD
  4. Czech koruna: CZK
  5. Danish krone: DKK
  6. Euro: EUR
  7. Hong Kong dollar: HKD
  8. Hungarian forint: HUF
  9. Israeli new shekel: ILS
  10. Japanese yen: JPY
  11. Malaysian ringgit: MYR
  12. Mexican peso: MXN
  13. New Taiwan dollar: TWD
  14. New Zealand dollar: NZD
  15. Norwegian krone: NOK
  16. Philippine peso: PHP
  17. Polish złoty: PLN
  18. Pound sterling: GBP
  19. Russian Ruble: RUB
  20. Singapore dollar: SGD
  21. Swedish krona: SEK
  22. Swiss franc: CHF
  23. Thai baht: THB
  24. United States dollar: USD
  25. Turkish Lira: TRY
  26. Indian Rupee: INR

Important Notes to remember before configuring Square

  1. This add-on will work with ARMember version 3.0 or higher.
  2. Square’s payment gateway only works with secure sites. For e.g. https://

Steps to Set Up Square For Your Website

In order to enable the Square Payment Gateway, first navigate to the ARMemberGeneral SettingsPayment Gateways page, and here enable the switch for the Square payment gateway.

general setting screen


Obtain API Credentials from Square

In order to configure the Square Payment Gateway, the following things are required: like Application ID, Access Token, and Location ID to use the Square Payment method.

  1. Firstly, if you do not have a Square account, then create it. For a sandbox/production account, click here.
  2. Log in to your Square Developer account and head over to your Square Developer Dashboard
  3. Square Payment Gateway Dashboard

  4. Create a new application (if you don’t have one); you can easily go to the step by clicking on the link here.
  5. Square New App

  6. Click on the Open button at Apps and select your payment mode, Sandbox or Production. After selecting the payment mode, you can see your application ID & access token.
  7. Square Credentials

  8. For your locations, from the sidebar, click on Locations. Here, simply choose the Sandbox or Production/Live payment method, and you will find the Location ID.
  9. Square Location ID

  10. After gathering the credentials, add them to your ARMember Square Payment Gateway settings.

  11. How to set a callback URL?

    Follow the below steps to set the Callback URL in your Square account

    1. Log in to your Square account
    2. At the sidebar, click on the OAuth Panel.
    3. On this page, click on the OAuth Tab.
    4. Here, set the callback URL http://yoursite.com/?arm-listener=arm_square_api in the Redirect URL textbox under the OAuth section. You can also get the Callback URL from the ARMemberGeneral SettingsPayment Gateways page. Here at Square you will be able to check the Callback URL in a box, copy it, and add it to the Redirect URL.
    5. Click on the Save button.
    6. Payment Gatewat Settings Screen


      Adding Payment Gateway for Front-End View

      Firstly, navigate to the ARMember ⇾ Manage Plans Page and create a plan accordingly.

      ARMember Square-plan Settings ( Payment Gateways )

      Go to your ARMember Configure Plan + Signup Page and select the ARMember Square Integration Gateway. That’s it.

      Configure Plan Screen


      Debug Log Data

      ARMember allows you to check the data that are being received from the payment gateways, whereby you can analyze whether the webhook_data event is reaching your site or not. As the ARMember will take any action on the basics of what is webhook_data received.

      To enable the logs, navigate to the ARMemberGeneral SettingsDebug Log Settings page. Here an option is available: Payment Gateway Debug Log Settings, under which you can enable the switch for Square and then save the changes. For more information, you can click here.

      Square Debug Log