# Manual Integration API (Open API)

If have your own e-commerce site and require manual integration, follow the steps below for further details.

### **Information required** 

To get started, please gather the following details from your senangPay dashboard:

Go to **Menu > Settings > Profile**

1\. **Merchant ID and Secret Key**: Find these in the **Shopping Cart Integration Link** section.

2\. **Return URL**: Specify the Return URL where senangPay will redirect buyers after payment processing.

3\. **Callback URL**:

* Provide the Callback URL, which serves as an alternative notification method if there is an issue with the transaction flow.
* For more information on the Callback URL, please [read here](https://guide.senangpay.my/callback-url/).

Ensure you have the below details ready to facilitate a smooth integration.

### **What parameters to send to senangPay.**

Below are the details of the elements in the table:

<table><thead><tr><th width="247">Item</th><th>Detail</th></tr></thead><tbody><tr><td><code>detail</code></td><td><p>Description displayed during payment (maximum 500 characters). Underscores (_) convert to spaces. </p><ul><li>Example: <code>Shopping_cart_id_30</code></li><li>Allowed characters: A-Z, a-z, 0-9, period (.), comma (,), dash (-), underscore (_).</li></ul></td></tr><tr><td><code>amount</code></td><td><p>The charge amount, formatted to 2 decimal places.</p><ul><li>Example: <code>25.50</code>.</li></ul></td></tr><tr><td><code>order_id</code></td><td><p>Identifies the shopping cart on return after payment (maximum 100 characters).</p><ul><li>Example: <code>3432D4</code></li><li>Allowed characters: A-Z, a-z, 0-9, dash (-).</li></ul></td></tr><tr><td><code>hash</code></td><td>Ensures data integrity between the merchant’s cart and senangPay. Refer to the "<a href="generate-secure-hash#how-to-generate-the-secure-hash">How to generate the secure hash</a>" section.</td></tr><tr><td><code>name</code></td><td>Adds the customer's name automatically. It's optional and can be edited.</td></tr><tr><td><code>email</code></td><td>Populates the customer's e-mail for them. Optional and can be modified.</td></tr><tr><td><code>phone</code></td><td>Inserts the customer's phone number. Optional and adjustable by the customer.</td></tr><tr><td><code>timeout</code> (optional)</td><td><p>Sets the payment timeout in seconds </p><ul><li>Example :  8 minutes = 480 seconds</li></ul><p> If not completed within this time, the payment will expire and redirect to the return URL. <strong>Minimum is 60 seconds</strong>; any amount below this defaults to 60 seconds. No timeout if omitted.</p></td></tr></tbody></table>

{% openapi src="<https://2457960571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMD7qOZbdoZKzaWe7sbiX%2Fuploads%2FSq5TCwLncGgf4wHKLvfw%2Fswagger%20spelling%20checked.yaml?alt=media&token=835856b9-c5c1-4ddc-af38-5abf130f690e>" path="/payment/{merchantID}" method="post" %}
[swagger spelling checked.yaml](https://2457960571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMD7qOZbdoZKzaWe7sbiX%2Fuploads%2FSq5TCwLncGgf4wHKLvfw%2Fswagger%20spelling%20checked.yaml?alt=media\&token=835856b9-c5c1-4ddc-af38-5abf130f690e)
{% endopenapi %}

<mark style="color:red;">\*The "Test it" option is available when using Firefox or Safari to test the API.</mark>

### Handling 'Return' and 'Callback' from senangPay

1\. The parameters will be send using the **GET** method.

2\. The parameters are sent to URL as configured in the return URL. [Refer above](#information-required).

The table below lists the details of the elements:

| Item            | Detail                                                                                                                                                                                                                                                                    |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| status\_id      | This is to indicate the status of the payment. It only has three values: 2 for **pending authorisation**, 1 for **successful** and 0 for **failed**.                                                                                                                      |
| order\_id       | This is the order that is sent to senangPay. This is to identify the shopping cart transaction.                                                                                                                                                                           |
| msg             | This is the message to describe the payment status. The maximum length is 100 characters. Take note that the message may contain underscores. You can replace the underscore as a space when displaying the message to your customers. Example: Payment\_was\_successful. |
| transaction\_id | <p>This is the transaction ID used by senangPay. You can use this ID to track the transaction in senangPay. The maximum length is 100 characters. <br>Example: 14363538840</p>                                                                                            |
| hash            | This is the data to ensure that data integrity has passed from senangPay to the merchant’s shopping cart. Refer to [this section](https://developer.senangpay.my/integration-api/generate-secure-hash#how-to-verify-if-the-secure-hash-is-correct) for more info.         |

3\. **Callback**: The parameter will be sent via **POST** method.


---

# 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://developer.senangpay.my/integration-api/manual-integration-api-open-api.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.