> ## Documentation Index
> Fetch the complete documentation index at: https://primer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchant Warrior

> Process Card, Apple Pay, and Google Pay payments through Merchant Warrior.

Merchant Warrior is an Australian payment gateway. Connect Merchant Warrior to Primer to process card payments, Apple Pay, Google Pay, and EFTPOS across AUD, CAD, EUR, GBP, JPY, NZD, SGD, and USD, and route them using Workflows.

## At a glance

### Supported payment methods

| Payment method | Payment method type | Integration guide |
| - | - | - |
| Card | `PAYMENT_CARD` | [Card](https://primer.io/docs/connections/payment-methods/card/overview.md) |
| Apple Pay | `APPLE_PAY` | [Apple Pay](https://primer.io/docs/connections/payment-methods/apple-pay/overview.md) |
| Google Pay | `GOOGLE_PAY` | [Google Pay](https://primer.io/docs/connections/payment-methods/google-pay/overview.md) |

Merchant Warrior uses Primer's standard card form and Primer's native Apple Pay and Google Pay integrations, so no Merchant Warrior-specific SDK code is required.

### Supported capabilities

| Capability | Card | Apple Pay | Google Pay |
| - | - | - | - |
| Authorization and capture | Yes | Yes | Yes |
| Refunds | Yes | Yes | Yes |
| Partial refunds | Yes | Yes | Yes |
| Merchant-initiated transactions | Yes | Yes | Yes |
| Cancel / Void | Yes | Yes | Yes |

### 3D Secure

Primer performs 3D Secure authentication using the [Perform 3DS action](https://primer.io/docs/workflows/apps/native-apps/primer-payments-app/perform-3ds-action.md) and passes the result to Merchant Warrior. Merchant Warrior does not run its own 3D Secure for payments processed through Primer.

## Get started with Merchant Warrior

### Before you begin

If this is your first connection, make sure to follow the [Get started guide](https://primer.io/docs/get-started/overview.md) to begin processing payments with Primer.

You need a Merchant Warrior test account and a separate production account. Contact Merchant Warrior to provision both — test accounts are free for all developers.

### Credentials

Merchant Warrior provides your credentials on account setup. Find them in the **Direct API** section of your Merchant Warrior account.

| Field | Where to find it |
| - | - |
| **Merchant API Key** | **Direct API** section of your Merchant Warrior account |
| **Passphrase for the API Key** | Same location as the Merchant API Key |

### Configure in the Dashboard

**1. Add Merchant Warrior to your Dashboard**

Go to [Integrations](https://dashboard.primer.io/integrations), select **New integration**, search for Merchant Warrior, and enter your **Merchant API Key** and **Passphrase**.

**2. Activate the payment methods on the Checkout**

Go to [Checkout](https://dashboard.primer.io/checkout) and activate the payment methods you want to offer.

**3. Route payments with Workflows**

In [Workflows](https://primer.io/docs/workflows/overview.md), select Merchant Warrior in the **Authorize payment** action. Add the **Perform 3DS** action before authorization for card payments.

### Prepare the client session

Most payment methods require no additional fields beyond the standard `orderId`, `currencyCode`, `amount`, and `customer` fields. The following optional field is available for card payments:

| Parameter | Required | Description |
| - | - | - |
| `metadata.edafRouting` | No | Set to `true` to route co-branded cards through EFTPOS by default. Set to `false` to use the international scheme. Omit to use Merchant Warrior's default routing. |

## Considerations

* **Supported currencies.** Merchant Warrior supports AUD, CAD, EUR, GBP, JPY, NZD, SGD, and USD. Confirm that your target currencies are enabled on the account before going live.

## Test in sandbox

Connect your Merchant Warrior test account to your Primer Sandbox environment. Use any standard Visa or Mastercard test number with a future expiry date and any CVV to simulate approved card payments.

## Go live

Before switching to production, confirm that:

1. You have added Merchant Warrior in your Primer **production** environment using your production **Merchant API Key** and **Passphrase**.
2. The target currencies are supported on your Merchant Warrior account: AUD, CAD, EUR, GBP, JPY, NZD, SGD, and USD.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.