> For the complete documentation index, see [llms.txt](https://docs.galaxypay.vn/upc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.galaxypay.vn/upc/payment-gateway/payment-solution/general-integration-steps.md).

# General integration steps

*<mark style="color:orange;">These are the general integration steps; the integration methods differ only in the input fields.</mark>*

* **Source demo:**&#x20;
  * .Net: <https://github.com/galaxypayvn/sample-upc-dotnet>
  * Node JS: <https://github.com/galaxypayvn/sample-upc-nodejs>

* **Integration Keys:**

<table><thead><tr><th width="160.33333333333331">Name</th><th width="296">Value</th><th>Remark</th></tr></thead><tbody><tr><td><strong>Signature Salt</strong> (SHA256)</td><td>GALAXY PAY will provide</td><td>Use for Signature</td></tr><tr><td><strong>API Key</strong></td><td>GALAXY PAY will provide</td><td>Use for Authenticate</td></tr><tr><td><strong>Base URL</strong></td><td><a href="https://uat-secure.galaxypay.vn/api/v1/transaction/pay">https://uat-secure.galaxypay.vn</a></td><td>UAT Environment</td></tr><tr><td></td><td><a href="https://secure.galaxypay.vn">https://secure.galaxypay.vn</a></td><td>PRODUCTION Environment</td></tr></tbody></table>

&#x20;        **Note:**

&#x20;           API Key and Salt Signature will differ between **UAT** and **PRODUCTION** environment.

* **Message structure:**
  * Service:                        REST API
  * HTTP Method:            POST
  * Content Type:             application/json
  * The Request structure:

<table><thead><tr><th width="62">#</th><th width="123">Component</th><th width="140">Param</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td><strong>Header</strong></td><td><strong>APIKey</strong></td><td><p>Key for authentication request. </p><p>Provided by GALAXY PAY.</p></td></tr><tr><td></td><td></td><td><strong>Signature</strong></td><td>Request signature, created with <mark style="color:red;"><strong>SHA256 &#x26; Salt</strong></mark></td></tr><tr><td></td><td></td><td>Accept</td><td>Accept encoding: <mark style="color:red;"><strong>application/json</strong></mark></td></tr><tr><td></td><td></td><td>Content-Type</td><td>Request content type: <mark style="color:red;"><strong>application/json</strong></mark></td></tr><tr><td>2</td><td><strong>Body</strong></td><td></td><td>JSON content</td></tr></tbody></table>

## General integration steps

{% stepper %}
{% step %}

### Step 1: APIKey & Salt:

* APIKey: Use for Authentication
* Salt: Use for Signature

GALAXY PAY will provide. If you don’t have an API Key & Salt, use: <https://uat-demo.galaxypay.vn/documents#auth>

{% endstep %}

{% step %}

### Step 2: Signature Algorithm: <a href="#step-2-signature-algorithm" id="step-2-signature-algorithm"></a>

Apply hash algorithm **SHA256** with **Salt**.

**Signature = SHA256(**<mark style="background-color:orange;">**SignData**</mark>**&#x20;+ Salt)**

Sample Code

<pre><code>// JavaScript Example
var salt = "GO@2021";

// JSON Data (JSON Object)
<strong>var request =
</strong>{
    "requestID": "14653fa1-2f69-4f4f-9d4b-240e1bebbdf3",
    "requestDateTime": 20220426083322,
    "requestData": {
        "apiOperation": "PAY",
        "orderID": "2a43e4b9-c5df-49e6-8b18-42af9bcd150e",
        "orderNumber": 205249008064,
        "orderAmount": 100000,
        "orderCurrency": "VND",
        "orderDateTime": 20220426083322,
        "orderDescription": "DEMO TRANSACTION",
        "paymentMethod": "DOMESTIC",
        "sourceType": "970400",
        "language": "vi"
    }
};

// JSON String (JSON Serialized as string)
// {"requestID":"14653fa1-2f69-4f4f-9d4b-240e1bebbdf3","requestDateTime":20220426083322,"requestData":{"apiOperation":"PAY","orderID":"2a43e4b9-c5df-49e6-8b18-42af9bcd150e","orderNumber":205249008064,"orderAmount":100000,"orderCurrency":"VND","orderDateTime":20220426083322,"orderDescription":"DEMO TRANSACTION","paymentMethod":"DOMESTIC","sourceType":"970400","language":"vi"}}
var signData = JSON.stringify(request);

// require('crypto-js');
// signature = SHA256(signData + salt) 
// b4b7cb5596680bb343f399922fc32e63fd69191c573e83c0383fd734531eab03
var signature = crypto.SHA256(signData + salt).toString();

</code></pre>

You can test Signature in [API Playground](https://uat-demo.galaxypay.vn/documents#post-/api/v1/transaction/pay)
{% endstep %}

{% step %}

### Step 3: Send request message

View the request fields for each integration method [here](/upc/payment-gateway/api-specification/payment.md)
{% endstep %}

{% step %}

### Step 4: Receive response message

View the response fields for each integration method [here](/upc/payment-gateway/api-specification/payment.md)
{% endstep %}
{% endstepper %}