# Gala Technology

<figure><img src="/files/0aeSqWEi0UmzzWohYitq" alt="" width="375"><figcaption></figcaption></figure>

**STEP 1**

Obtain a **merchantID** and **merchantSecret** from Gala Technology. If you intend to send **merchantPwd**, please configure it on your Merchant Account with Gala.

<figure><img src="/files/GUB11B2fR7hsb7ABRYnV" alt="" width="545"><figcaption></figcaption></figure>

**STEP 2**

Activate the Gala Technology gateway and enter your credentials.

<figure><img src="/files/ZNSFz1h7lnB7xTPRc22P" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Steps 3-5 can be skipped if using CheckoutChamp hosted pages
{% endhint %}

**STEP 3**

Add the hidden input browserData inside of the same form as the card input.

`<input type="hidden" name="browserData" value="" id="browserData">`

**STEP 4**

Add this script to your page before the closing body tag.

```
Script to get browserData:
<script type="text/javascript">
    const navigator = window.navigator;
    const browserData = {
        acceptHeader: 'application/json',
        colorDepth: screen.colorDepth,
        javaEnabled: navigator.javaEnabled(),
        javaScriptEnabled: true,
        language: navigator.language,
        screenHeight: screen.height,
        screenWidth: screen.width,
        timeZoneOffset: (new Date()).getTimezoneOffset().toString(),
        userAgent: navigator.userAgent
    };
    document.getElementById('browserData').value = JSON.stringify(browserData);
</script>
```

**STEP 5**

If using Secure 3DS be sure the checkout page supports the challenge requests

[Direct API 3DS Instructions](/crm/gateway-setup/direct-api-3ds-instructions.md)

**REFUNDS**

Refunds require special consideration.

Be familiar with [standard refund instructions](/crm/customer-section/customer-service/refund-void-a-transaction.md).

It is highly recommended to refund entire orders instead of transactions. Refunding an entire order handles the difference between settled and unsettled transactions at Gala. Refunding a sale transaction, especially in the first 24-36 hours, may fail because it is not yet settled at Gala. If a refund fails then do attempt to void the sale.

Similar instructions should be followed when refunding from Shopify. It is highly recommended to refund an entire order instead of individual line items. There are certainly instances when a line item refund is necessary but be aware of 2 considerations:

* Gala does not allow a partial void (cancellation) of an unsettled transaction. A partial refund must be a refund. And that refund will fail until the sale is settled. CheckoutChamp will automatically re-attempt that refund for 3 days (see notes about the refund queue in the standard instructions). Consumers will not see the refund until it is successful.
* Gala only allows one partial refund (line item) per day because that refund must settle before the remaining balance can be validated on subsequent partial refunds. This can cause multiple line item refunds to be spaced out over several days (see notes about the refund queue in the standard instructions).

If a refund or cancellation is done in the MMS portal then the transaction should be refunded in CheckoutChamp using the Externally Refunded checkbox.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.checkoutchamp.com/crm/gateway-setup/gateway-integrations/gala-technology.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.