Cardknox

How to enable Cardknox Credit Card on a merchant.

Cardknox is a payment gateway offering secure credit card processing and other payment solutions, with features for easy integration and support for various transaction types, including authorization-only transactions.

Features

Refund A creditcard payment processed with Cardknox can be / according to its status. ✅ Payment Authorization Payments can be authorized by customers using Credit Card. ✅ Payment Capture Payment authorizations made using Credit Card payment methods can be captured. This step happens automatically with CHARGE transactions.

Resources

Configuration

To set up and configure Cardknox, obtain your API key (xKey) from the Cardknox developer portal. This key is essential for authorization during transaction requests. For further assistance, contact Cardknox support at www.cardknox.com/contact.

This table describes the required or possible attributes needed to configure a merchant product for this type.

NameTypeDescriptionRules
xKeyAPI key for authenticating Cardknox transactions. Examples: abcd1234.

Enabling this Product

Using create-merchant-product API you can add a new product to your merchant record. Below is an example configuration for the payload of that request.

{
  "line": "payments",
  "product": "creditcard",
  "provider": "cardknox",
  "config": {
    "xKey": "abcd1234"
  }
}

Data Mapping

The following bullet points outline the mapping of data fields between the Authvia platform and the Cardknox system, detailing the correspondence of specific attributes for seamless data integration.

  • Authvia transaction.references.external maps to Cardknox xRefNum
  • Authvia transaction.amount maps to Cardknox xAmount
  • Authvia transaction.paymentMethod.cardNumber maps to Cardknox xCardNum
  • Authvia transaction.paymentMethod.expirationMonth maps to Cardknox xExp
  • Authvia transaction.paymentMethod.nameOnCard maps to Cardknox xBillFirstName
  • Authvia transaction.paymentMethod.streetAddress maps to Cardknox xBillStreet
  • Authvia transaction.paymentMethod.city maps to Cardknox xBillCity
  • Authvia transaction.paymentMethod.state maps to Cardknox xBillState
  • Authvia transaction.paymentMethod.zipCode maps to Cardknox xBillZip
  • Authvia transaction.paymentMethod.country maps to Cardknox xBillCountry
  • Authvia transaction.references.external maps to Cardknox xDescription