Moneris Surcharge Lookup API is one of 15 APIs that Moneris publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Surcharge Lookup. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes
1 operation
across 1 path,
and defines 39 schemas.
It is described by OpenAPI 3.2.0, at version 2.6.1.
Requests are made against 2 base URLs: https://api.sb.moneris.io, https://api.moneris.io.
1 operations1 paths39 schemas1 POST
Metadata
The identity and technical contract details declared by the specification.
Moneris Surcharge Lookup API declares
2 security schemes
for authenticating requests.
An API key is passed in the header as X-Api-Key (ApiKeyAuth).
It supports OAuth 2.0 (OAuth2) using the clientCredentials flow, exposing 14 scopes.
ApiKeyAuth — An API key is a token that a client provides when making API calls. API keys are supposed to be a secret that only the client and server know about.
OAuth2 — OAuth 2.0 is an authorization protocol that gives an API client limited access to user data on a web server. OAuth relies on authentication scenarios, that all…
Paths & Operations 1
Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.
The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are paymentMethod (9 properties), cardInformation (8 properties), error (7 properties), SurchargeEligibility (6 properties). Each schema is shown below with its type and property counts.
expiryYear
integer
Displays the card expiration year. Accepted format: YYYY
currency
string
Provides the three letter currency code according the ISO 4217 standard. For a complete list of currency codes, visit: https://en.wikipedia.org/wiki/ISO4217
paymentMethodCard
Credit/Debit/Gift Card payment method details.
2 required
paymentMethodWithId
object
Use existing unique payment method identifier.
2 properties2 required
cardholderName
string
Cardholder name
paymentMethodPermanentToken
A Permanent Token is issued by Moneris to the merchant and represents the card details. This option is used for legacy purposes.
2 required
cardInformation
object
Information about the card being used for the transaction
8 properties
storePaymentMethod
string
Store this payment method created through this payment for future use. - DONOTSTORE: Payment method will not be stored. - CARDHOLDERINITIATED: Payment method t…
cardNumber
string
Identifies the customer's credit or debit card number (Primary Account Number).
companyName
stringnull
Identifies the associated company name
cardSecurityCode
string
CVD value located on credit card. The CVD value (supplied by the cardholder) must only be passed to the payment gateway. Under no circumstances may it be store…
modifiedAt
stringnull
Time at which the object was modified
customData
objectnull
Merchant can send custom meta data with the transaction in this object. Moneris will echo these values back in response.
paymentAccountReference
stringnull
Used to link Primary Account Number (PAN) based transactions and transactions on associated payment tokens without using the PAN as the linking mechanism.
cardFingerprint
stringnull
Unique card identifier. Fingerprinting randomly assigns identfiers for cards that share the same Primary Account Number (PAN) to easily identify when multiple…
cardBrand
stringnull
Displays the card brand name associated with the card type.
token
string
Created when a temporary token is created and returned. This acts as a unique profile identifier, and is a required value for temporary token transactions.
parameterError
object
Request property or header related error.
4 properties2 required
cardholderInformation
objectnull
Information about the holder of the card.
2 properties1 required
createdAt
string
Time at which the object was created
idempotencyKey
string
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."
error
object
Error response details.
7 properties1 required
paymentMethodRequestSource
string
The source of Payment Method being used. It can be: - The Id of a Payment Method already created. - Permanent Token. - Temporary Token. - Card. - E-Wallet.
paymentMethodRequestBase
object
Payment Method details. Note: If defined, this will result in the creation of Payment Method as defined in the Payment Method API.
5 properties1 required
contactDetails
objectnull
Contact details
2 properties
surChargePaymentMethodRequest
surcharge payment Method details. Note: If defined, this will result in the creation of a Permanent Payment Method as defined in the Payment Method API.
money
object
Monetary amount. Note: The value must be in cents. Therefore $10.59 must be sent as 1059.
2 properties2 required
paymentMethod
object
Payment method response object
9 properties4 required
cardPaymentMethodInformation
object
Details about the card used in the payment method.
5 properties4 required
paymentMethodId
string
Unique Identifier of the payment method.
paymentMethodTemporaryToken
A Temporary Token is issued by Moneris to the merchant and represents the card details. Please review the Hosted Tokenization feature documentation to learn ho…
2 required
card
object
Card details
4 properties4 required
apiVersion
string
The endpoint's API Version. Must be provided through headers.
issuer
stringnull
Card issuer.
expiryMonth
integer
Card expiration month. Format must be MM
merchantId
string
Thirteen character long identification provided to merchants by Moneris.
SurchargeEligibilityRequest
object
3 properties3 required
amount
integer
Amount
SurchargeEligibility
object
6 properties6 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Moneris Surcharge Lookup API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
