Create Kount Inquiry

post

https://api.sb.moneris.io/kount-inquiries

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

idempotencyKey

string

required

length between 1 and 36

A Unique Identifier that is required for handling idempotent requests.

Note: Moneris encourages the use of UUID Version 4 in APIs as an idempotency key."

orderId

string | null

^[a-zA-Z0-9-_]+$

Indicates the merchant-defined transaction identifer or order ID. Identifiers are unique for every Purchase, Pre-Authorization and Independent Refund transaction

Note: No two transactions of these types may have the same order ID. Field only accepts alphanumerical characters, dashes and underscores.

kountAccountId

string

required

length between 6 and 6

6 digit local identifier used by the merchant to identify the kount inquiry request

kountApiKey

string

required

length ≤ 256

The API key for the associated with the Kount Merchant ID

originatedFromCallCenter

boolean

required

Refers to Kount's Call center indicator.

Flag indicating whether risk inquiry request originates from a call center environment If the customer service agents navigate to a separate order entry page that does not collect iframe data: When sending the kount_inquiry request, set call_center_ind to Y If the customer service agents navigate to the same order entry page as the customer: When sending the kount_inquiry request, set call_center_ind to N If Risk Inquiry Service call does not originate from a call center environment, set call_center_ind to N

True for YES, False fo NO

sessionId

string

required

length ≤ 32

Unique Session ID; must be unique over a 30-day span

websiteId

string

required

length ≤ 8

Website identifier of where order originated

paymentDetails

required

Payment Data

string

required

length between 1 and 320

Contains the customer's email address.

For standard email protocols, visit: https://www.rfc-editor.org/rfc/rfc5322

products

array of objects

required

List of product items part of the transaction

products*

automaticNumberId

string | null

Automatic Number Identification (ANI) submitted with order If the ANI cannot be determined, merchant must pass 0123456789 as the ANID NOTE: This field is only valid for phone-to-web requests where customer service agents navigate to a separate order entry page that does not collect iframe data Risk Inquiry Service submissions

billingAddress

object | null

The postal address including street, town/city, province, and postal code.
Optionally an unit number can be provided.

shippingAddress

object | null

The postal address including street, town/city, province, and postal code.
Optionally an unit number can be provided.

dateOfBirth

date | null

Date of Birth.

timestamp

date-time | null

This is timestamp associated with the creation of a user in Kount service.

gender

string | null

enum

An individual's gender

Allowed:

customerName

string | null

Customers full name

financialOrderId

string | null

Unique identifier for transactions at Kount

shippingType

string | null

enum

Shipping type. The following nomenclature is expected for shipping types to be passed to Kount. NOTE:These three attributes can be used to pass custom attribute data if you want to correlate some data with the returned response

Allowed:

ipv4

string

required

Internet Protocol version 4 (IPv4).

customData

object | null

Merchant can send custom meta data with the transaction in this object. Moneris will echo these values back in response.

Headers

X-Merchant-Id

string

required

length between 13 and 13

Thirteen character identification code.

Note: This code is provided by Moneris and is required to identify the Merchant executing the transaction."

Api-Version

string

required

Defaults to 2025-08-14

The endpoint's API Version.

Must be provided through the headers section.

X-Correlation-Id

string

Correlates a series of requests within the same flow.

Note: This ID is generated by Moneris with every request or response, if it doesn't exist.
Merchants are to echo back the value with every request that is part of the call flow."

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

201Kount Inquiry was successfully approved.

202Kount Inquiry accepted and is under review.

400Bad Request.

401Not authorized. The user does not have a valid API Key or Access Token.

403Forbidden. The user does not have permission to access the requested resource.

409Request could not be completed due to a conflict with resource state or existing idempotency key.

422The API cannot complete the requested action due to semantic or business validation errors.

429Too Many Requests

500Unexpected error.

503Service Temporarily Unavailable