The Admoji WooCommerce Gateway is a WordPress plugin that turns your WooCommerce store into an Admoji-powered checkout. Customers complete purchases on your WordPress site using WooCommerce as the storefront, while Admoji handles payment processing, customer records, orders, reporting, and affiliate tracking in the background. Every successful transaction is recorded in Admoji in real time.

Download Plugin

Step 1: Install the Plugin in WordPress

1. Download the plugin ZIP file using the button above.

2. In your WordPress admin, go to Plugins > Add New, then click Upload Plugin. Choose the ZIP file, click Install Now, and activate the plugin.

3. After activation, go to WooCommerce > Settings > Payments, find Admoji Payment Gateway, and click Manage to open the gateway settings.

Step 2: Configure the Gateway Settings

Fill in the following fields in the Admoji Payment Gateway settings:

• Enable this payment gateway: Check this box to offer Admoji as a payment method at checkout.

• Test Mode: When enabled, the SSL requirement for the gateway is relaxed. Turn this off in production.

• Title: The label customers see at checkout (for example, "Pay with Credit Card").

• Description: Short text shown to the customer during checkout.

• Admoji API Key: Your Admoji API key (for example, secret_xxxxx or pk_xxxxx). You can find this in your Admoji account settings.

• Admoji Campaign ID: The campaign ID in Admoji that should receive the orders.

• Fallback Affiliate ID: (Optional) Used when no affiliate ID is present in the URL.

• Admoji 3DS Application ID: (Optional) Required only if you use 3D Secure card authentication.

• Enable auto mark as complete: When checked, orders are marked complete in Admoji immediately after a successful payment.

• Force Processor ID: (Optional) Route all transactions through a specific processor. Leave empty for automatic selection. Required if you plan to use the Subscription Migration tool.

Step 3: Link Your WooCommerce Products to Admoji

Each WooCommerce product must be linked to its corresponding product in Admoji. You can do this automatically using the Sync Products tool (recommended), or manually on each product.

Option A — Sync Products automatically (recommended)

The Sync Products tool pushes your entire WooCommerce catalog to Admoji in one click. Products that do not yet exist in Admoji are created; products that were previously synced are updated in place. The Admoji Product ID is saved automatically on each product, so no manual entry is needed.

1. In your WordPress admin, go to WooCommerce > Settings > Payments > Admoji Payment Gateway > Manage.

2. Scroll down to the Data Tools section and click Sync Products.

3. A progress bar will appear. Wait for it to complete. Once finished, all products have their Admoji Product ID assigned and are ready for checkout.

Option B — Link products manually

If you prefer to link individual products by hand (for example, to map a WooCommerce product to an existing Admoji product that was not created by the sync):

1. In WordPress, go to Products and create or edit a product.

2. Open the Advanced tab in the Product data section, find Admoji Product ID, and enter the matching product ID from Admoji CRM.

3. Save the product. Repeat for every product in your catalog.

Step 4: Link Product Variations to Admoji

For variable products (for example, size or color), each variation must map to an Admoji variant. The Sync Admoji Variants button automates most of this.

1. In the Product data dropdown, select Variable product.

2. Open the Attributes tab.

3. Click Add new, enter the attribute name (for example, "Color"), add values separated by | (for example, "Red | Blue | Green"), then click Save attributes.

4. Open the Variations tab.

5. Click Generate variations (or create variations manually if you prefer).

6. Confirm Admoji Product ID is set on the Advanced tab, then click Save draft or Publish / Update so the product is saved. After that, the Sync Admoji Variants button appears in the Variations toolbar (next to Generate variations).

7. Click Sync Admoji Variants. The plugin fetches variants from Admoji and fills in Admoji Variant ID, Regular price, and SKU for each variation where possible.

8. Click Save changes in the Variations section (or update the product) so the synced values are stored. On each order, the plugin sends the correct variant data to Admoji.

Step 5: Migrate Existing Customers (optional)

If you have existing WooCommerce customers that were created before the plugin was installed, use the Customer Migration tool to push them to Admoji. Customers that have already been migrated are detected automatically and skipped, so the tool is safe to run more than once.

1. Go to WooCommerce > Settings > Payments > Admoji Payment Gateway > Manage.

2. In the Data Tools section, click Migrate Customers.

3. A progress bar tracks the batch operation. Once complete, all eligible customers have an Admoji Customer ID stored in their WordPress user profile.

Step 6: Migrate Existing Subscriptions (optional)

If your store uses WooCommerce Subscriptions and you want to transfer active recurring billing to Admoji, use the Subscription Migration tool. Complete Steps 3 and 5 first — products must be synced and customers must be migrated before subscriptions can be transferred.

1. Confirm Force Processor ID is filled in under the gateway settings (Step 2).

2. In the Data Tools section, click Migrate Subscriptions. The button is disabled until WooCommerce Subscriptions is detected as active.

3. A progress bar tracks the migration. Each active subscription is transferred to Admoji recurring billing and the Admoji Subscription Interval ID is stored on the WooCommerce subscription record.

Step 7: Affiliate Tracking

The plugin reads affiliate and sub-affiliate parameters from the URL and passes them to Admoji with the order. Supported parameters:

• affid or affId: Affiliate ID.

• s1 through s5: Sub-affiliate IDs.

If no affiliate ID is in the URL, the plugin uses the Fallback Affiliate ID from the gateway settings (if configured).

Step 8: How Orders Are Processed

When a customer pays with the Admoji gateway:

1. The plugin creates or reuses the customer record in Admoji using the billing details from checkout.

2. The order is sent to Admoji with line items, payment information, and affiliate data.

3. If the payment succeeds, the WooCommerce order is marked paid and the Admoji Order ID, Transaction ID, and Customer ID are saved on the order in WordPress.

4. If Enable auto mark as complete is enabled, the order is also marked complete in Admoji immediately.

Step 9: View Admoji Data in WordPress

After checkout, you can see Admoji references in WordPress in two places:

• Orders list: An Admoji Order ID column (on the classic orders screen) shows the linked Admoji order when available.

• Order screen: The Admoji Information meta box shows Customer ID, Order ID, and Transaction ID for that WooCommerce order.

Full customer history, reporting, and affiliate attribution remain available in your Admoji CRM as usual.