> For the complete documentation index, see [llms.txt](https://monexapidoc.ibanera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://monexapidoc.ibanera.com/integration-and-function-flow/1.-request-a-quote.md).

# 1. Request a Quote

## POST Request to {Endpoint}/pay/getQuote

**Calling getQuote only requires two body parameters in the JSON format. MerchantID is associated with the storefront that is the merchant.**

<table><thead><tr><th>Parameter</th><th width="194">Type</th><th>Details</th></tr></thead><tbody><tr><td><strong>merchantID</strong></td><td>String</td><td>Merchant Username for given merchant</td></tr><tr><td><strong>orderAmount</strong></td><td>String</td><td>Order Amount in USD</td></tr></tbody></table>

**JSON Body Request Example:**

<pre><code>{
   "<a data-footnote-ref href="#user-content-fn-1">merchantID</a>": "1234567890",
   "orderAmount": "100.00"
}
</code></pre>

**JSON Success Response (Status Code 200)**&#x20;

```json
{
    "success": true,
    "subTotal": 11.11,
    "fee": 0.5,
    "orderTotal": 11.61,
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjaGFudElEIjoidHN0LTEiLCJvcmRlckFtb3VudCI6IjExLjExIiwiaWF0IjoxNjg5MjQ4NDM4LCJleHAiOjE2ODkyNDkwMzh9.y8KAMW23mXFgWpxOvLsqhFoUuBP5osafp4-cV2ZDmRw",
    "tokenExpire": "600"
}
```

**JSON Response Body:**

<table><thead><tr><th>Parameter</th><th width="173.33333333333331">Type</th><th>Details</th></tr></thead><tbody><tr><td>success</td><td>Boolean</td><td>True if request is successful</td></tr><tr><td>subTotal</td><td>Number</td><td>The requested order amount</td></tr><tr><td>fee</td><td>Number</td><td>The fee amount for the given merchant</td></tr><tr><td>total</td><td>Number</td><td>The summation of the subtotal and fee. Amount to be charged by the card when authorized</td></tr><tr><td>token</td><td>String</td><td>Quote token, used as a parameter when authorizing a payment</td></tr><tr><td>tokenExpire</td><td>String</td><td>The expire time for the quote</td></tr></tbody></table>

**Information regarding tokens:**&#x20;

Tokens are active for 10 minutes following the time they’ve been created (600 seconds). Merchants should consider this and make repetitive requests to getQuote, **if needed**, to ensure that when a payment is authorized, there is an active quote that is associated with that order. Request to authorize a transaction with an expired quote will revert.

[^1]: