> ## 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.

# HitPay

> Process Southeast Asian alternative payment methods through HitPay.

HitPay is an all-in-one payment platform for small and medium businesses in Southeast Asia and beyond. Through Primer you can offer HitPay's local wallets and buy now, pay later methods across Singapore, Malaysia, Hong Kong and Australia.

> [!NOTE]
>
> HitPay is an alternative payment method connection. It does not process cards, and it does not support recurring or merchant-initiated payments. Every payment through HitPay is a one off, customer-initiated transaction.

## At a glance

### Supported payment methods

| Payment method | Payment method type | Integration guide |
| - | - | - |
| Atome | `HITPAY_ATOME` | [Atome via HitPay](https://primer.io/docs/connections/payment-methods/atome/hitpay.md) |
| GrabPay | `HITPAY_GRABPAY` | [GrabPay via HitPay](https://primer.io/docs/connections/payment-methods/grabpay/hitpay.md) |
| ShopeePay | `HITPAY_SHOPEEPAY` | [ShopeePay via HitPay](https://primer.io/docs/connections/payment-methods/shopeepay/hitpay.md) |
| WeChat Pay | `HITPAY_WECHAT` | [WeChat Pay](https://primer.io/docs/connections/payment-methods/wechat-pay/hitpay.md) |

### Supported capabilities

| Capability | Alternative payment methods |
| - | - |
| Authorization | Yes |
| Refund | Yes |
| Partial refund | Yes |
| Multiple refunds | Yes |
| Recurring and merchant-initiated payments | No |
| Network tokens | Not applicable |

> [!NOTE]
>
> Some capabilities must be enabled on your HitPay account. Contact HitPay to confirm which features are available to you.

## Get started with HitPay

### 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 an active HitPay merchant account. Contact HitPay to obtain your API credentials and to confirm which payment methods are enabled on your account.

### Credentials

| Field | Where to find it |
| - | - |
| **API Key** | Contact HitPay to obtain your API key. |

### Configure in the Dashboard

**1. Add HitPay to your Dashboard**

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

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

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

**3. Route payments with Workflows**

In [Workflows](https://primer.io/docs/workflows/overview.md), select HitPay in the **Authorize payment** action.

## Considerations

* **One off payments only.** HitPay does not support recurring or merchant-initiated payments. If your use case needs a stored credential charged later, route it to a different connection.
* **No card processing.** HitPay is an alternative payment method connection. Cards, Apple Pay and Google Pay are not available through it.
* **Payments are asynchronous.** Each HitPay method completes when the customer finishes in their wallet or BNPL app, so the payment reaches a final status through a callback rather than in the authorization response. Fulfil orders only on a final status.
* **Payment methods are enabled by HitPay.** Confirm with HitPay which methods are live on your account before you activate them on the Checkout.

## Test in sandbox

Connect your HitPay **test** account to your Primer Sandbox environment.

## Go live

Before switching to production, confirm that:

1. Your HitPay production account is active for the payment methods you want to offer.
2. You have added HitPay in your Primer **production** environment using your **production** API key.
3. You handle the [PAYMENT.STATUS webhook](https://primer.io/docs/api-reference/endpoints/v2.4/payment-webhooks/payment-status-update.md) and fulfil orders only on a final status.


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