cardknox-sdk-js

SDK

HTTPS

To enable https on the Pax device, please contact support.

To avoid the need for a self-signed certificate, Cardknox provides a SSL certificate pointing to the local IP address. The format for the host name is <ip-{IP address replacing the periods with dashes}.mylocaldevice.com> i.e. for IP address 192.168.1.1 the host name would be ip-192-168-1-1.mylocaldevice.com. The SDK will automatically format the host name correctly when the protocol is https.

A DNS entry must exist, mapping the host name to the IP address. The SDK will check that the entry exists if there are network errors.

To create a DNS entry, use the tool located here. This can also be done via API.

curl --request POST \
  --url http://localdevice.us-west-2.elasticbeanstalk.com/api/dnsrecord/save \
  --header 'Content-Type: multipart/form-data' \
  --form ip=192.168.1.1

Process

Process a transaction

Get Signature

Prompts for signature on the device

This returns a base64 encoded PNG without the data header.

TransactionRequest

Settings

xCommand

List of supported transaction types.

These enums are available from the SDK.