1. Request a Quote

Request a quote on an order.

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.

Parameter	Type	Details
amount	Number	Order Amount in USD

JSON Body Request Example:

{
   "orderAmount": 11.10
}

JSON Success Response (Status Code 200)

{
    "success": true,
    "subTotal": 11.1,
    "fee": 0,
    "orderTotal": 11.1,
    "token": "0551aa2f-9e28-4385-800f-65219ffdf695",
    "tokenExpire": "2024-03-21T16:08:44.664Z"
}

JSON Response Body:

Parameter	Type	Details
success	Boolean	true if request is successful
subTotal	Number	The requested order amount
fee	Number	The fee amount for the given merchant
orderTotal	Number	The summation of the subtotal and fee. Amount to be charged by the card when authorized.
token	String	Quote token, used as a parameter when authorizing a payment.
tokenExpire	Date/String	The expire time for the quote

Information regarding tokens:

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. Requests to authorize a transaction with an expired quote will revert.

See the following page for error & status codes associated with requesting a quote.