Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the cl-moneris Reference Manual, generated automatically by Declt version 4.0 beta 2 "William Riker" on Mon Aug 15 03:50:02 2022 GMT+0.
Next: Systems, Previous: The cl-moneris Reference Manual, Up: The cl-moneris Reference Manual [Contents][Index]
This is a Common Lisp library providing access to the Moneris payment processing (http://www.moneris.com/) HTTPS POST API. The basic use pattern is to create a merchant-token with your store's information (API token, store ID, and the access URI you received from Moneris), then call the 'process' function with the merchant-token and a transaction (you can create transactions with the 'purchase,' 'correction,' and 'refund' functions provided - see their documentation strings for details). 'process' returns multiple values: txn-id - transaction ID code - numeric response code code-description - response code description message - message returned in response response-xml - parsed XML of response response-string - raw XML response string response-xml contains all the information you need to generate a client receipt/invoice; consult the Moneris API documentation (https://www.eselectplus.ca/en/downloadable-content) to learn about its format and fields. The file test/moneris-test.lisp provides examples using the Moneris API test server. cl-moneris was originally authored by Wade Humeniuk. It was converted and released by Vladimir Sedachcl-moneris is available under the ISC (BSD) license, except for the unit tests, which are released into the public domain.
Next: Files, Previous: Introduction, Up: The cl-moneris Reference Manual [Contents][Index]
The main system appears first, followed by any subsystem dependency.
An interface to the Moneris payment processing service (HTTP).
Vladimir Sedach <vsedach@gmail.com>
ISC
Next: Packages, Previous: Systems, Up: The cl-moneris Reference Manual [Contents][Index]
Files are sorted by type and then listed depth-first from the systems components trees.
Next: cl-moneris/package.lisp, Previous: Lisp, Up: Lisp [Contents][Index]
cl-moneris (system).
Next: cl-moneris/response-codes.lisp, Previous: cl-moneris/cl-moneris.asd, Up: Lisp [Contents][Index]
cl-moneris (system).
Next: cl-moneris/moneris.lisp, Previous: cl-moneris/package.lisp, Up: Lisp [Contents][Index]
package.lisp (file).
cl-moneris (system).
Previous: cl-moneris/response-codes.lisp, Up: Lisp [Contents][Index]
response-codes.lisp (file).
cl-moneris (system).
Next: Definitions, Previous: Files, Up: The cl-moneris Reference Manual [Contents][Index]
Packages are listed by definition order.
Next: Indexes, Previous: Packages, Up: The cl-moneris Reference Manual [Contents][Index]
Definitions are sorted by export status, category, package, and then by lexicographic order.
Next: Internals, Previous: Definitions, Up: Definitions [Contents][Index]
Next: Generic functions, Previous: Public Interface, Up: Public Interface [Contents][Index]
Generate a transaction to void a same-day purchase. No purchase will appear on the customer’s credit card.
Description of input parameters:
order-id (string, 50 chars max, alphanumeric)
Merchant defined unique transaction identifier - must reference a
previously processed purchase transaction order-id.
txn-id (string, 255 chars max, alphanumeric)
This must be the value returned as the Txn_number in the
response to the original purchase.
crypt-type (string, 1 char, alphanumeric)
E-Commerce Indicator:
1 - Mail Order/Telephone Order - Single
2 - Mail Order/Telephone Order - Recurring
3 - Mail Order Telephone Order - Instalment
4 - Mail Order Telephone Order - Unknown Classification
5 - Authenticated E-commerce Transaction (VBV)
6 - Non Authenticated Ecommerce Transaction (VBV)
7 - SSL enabled merchant
8 - Non Secure Transaction (Web or Email Based)
9 - SET Non Authenticated transaction
Send a ’purchase’, ’correction’, or ’refund’ transaction for processing to Moneris merchant account specified by merchant-token.
If the Moneris mpg server returns an HTTP status code other than 200, raises a moneris-post-error
If transaction is declined, raises a moneris-transaction-error
If transaction is successfuly processed, returns (as multiple values):
txn-id - transaction ID
code - numeric response code
code-description - response code description
message - message returned in response
response-xml - parsed XML of response
response-string - raw XML response string
Generate a purchase transaction for processing.
Description of input parameters:
order-id (string, 50 chars max, alphanumeric)
Merchant defined unique transaction identifier - must be uniquely
generated by caller for every Purchase.
amount (string, 9 chars max, decimal)
Amount of the transaction. This must contain 3 digits with two
penny values. The minimum value passed can be 0.01 and the maximum
9999999.99
pan (string, 20 chars max, numeric)
Credit Card Number - no spaces or dashes. Most credit card numbers
today are 16 digits in length but some 13 digits are still accepted
by some issuers. This field has been intentionally expanded to 20
digits in consideration for future expansion and/or potential
support of private label card ranges.
expdate (string, 4 chars, numeric)
Expiry Date - format YYMM no spaces or slashes. PLEASE NOTE THAT
THIS IS REVERSED FROM THE DATE DISPLAYED ON THE PHYSICAL CARD WHICH
IS MMYY
cust-id (string, 50 chars max, alphanumeric)
This is an optional field that can be sent as part of a Purchase or
PreAuth request. It is searchable in the Moneris Merchant Resource
Centre. It is commonly used for policy number, membership number,
student ID or invoice number.
Generate a transaction to refund a purchase.
order-id (string, 50 chars max, alphanumeric)
Merchant defined unique transaction identifier. For Independent
Refund attempts, must be uniquely generated by caller. For refunds
of previous purchases, must reference a previously processed
purchase transaction order-id.
txn-id (string, 255 chars max, alphanumeric)
Used when performing follow on transactions - this must be the value
returned as the Txn_number in the response to the original purchase.
amount (string, 9 chars max, decimal)
Amount of the transaction. This must contain 3 digits with two
penny values. The minimum value passed can be 0.01 and the maximum
9999999.99
crypt-type (string, 1 char, alphanumeric)
E-Commerce Indicator:
1 - Mail Order/Telephone Order - Single
2 - Mail Order/Telephone Order - Recurring
3 - Mail Order Telephone Order - Instalment
4 - Mail Order Telephone Order - Unknown Classification
5 - Authenticated E-commerce Transaction (VBV)
6 - Non Authenticated Ecommerce Transaction (VBV)
7 - SSL enabled merchant
8 - Non Secure Transaction (Web or Email Based)
9 - SET Non Authenticated transaction
Next: Conditions, Previous: Ordinary functions, Up: Public Interface [Contents][Index]
code.
Next: Classes, Previous: Generic functions, Up: Public Interface [Contents][Index]
Superclass of network errors or
transaction-declined conditions. Handle this when you don’t care why
your transaction failed to process.
error.
Condition raised due to network error
:http-code
:http-headers
:http-body
Reason phrase from HTTP header status line
:reason-phrase
Condition raised when transaction is declined
Text description of Moneris response code
:code-description
Message returned by Moneris
:message
XML string returned by Moneris
:raw-xml
Parsed XML returned by Moneris
:parsed-xml
Previous: Conditions, Up: Public Interface [Contents][Index]
Merchant-token objects specify your unique Moneris store information.
Full URI of the Moneris Server e.g. https://moneris.com/mpg
:moneris-uri
This slot is read-only.
Your api token issued during Moneris store creation.
:api-token
This slot is read-only.
Previous: Public Interface, Up: Definitions [Contents][Index]
Next: Ordinary functions, Previous: Internals, Up: Internals [Contents][Index]
Next: Generic functions, Previous: Special variables, Up: Internals [Contents][Index]
Previous: Ordinary functions, Up: Internals [Contents][Index]
Your api token issued during Moneris store creation.
Full URI of the Moneris Server e.g. https://moneris.com/mpg
Your store-id issued during Moneris store creation.
Previous: Definitions, Up: The cl-moneris Reference Manual [Contents][Index]
Jump to: | (
A C F G H I L M P R S |
---|
Jump to: | (
A C F G H I L M P R S |
---|
Next: Data types, Previous: Functions, Up: Indexes [Contents][Index]
Jump to: | *
A C H M P R S |
---|
Jump to: | *
A C H M P R S |
---|
Jump to: | C F M P R S |
---|
Jump to: | C F M P R S |
---|