Pay InCloud devices

PAX A920 guide

Learn how to set up and register a PAX A920 device with the API to make card-present sales

Applies to:Developers

The PAX A920 is an integrated portable payment device that lets you accept payments via magnetic stripe, EMV chip, and NFC contactless technology. This guide walks through the steps to set up your new PAX device and register it with Payabli so you can start processing transactions.

The PAX A920 is supported only in production environments, and can’t be used in sandbox.

Setup

The next sections cover how to unbox and set up your PAX A920 device.

Prepare the device

When you receive your PAX A920 device, follow these instructions to unbox and get the device ready to register in Payabli.

1

Unbox the Device

The PAX A920 comes with a USB power cord and 3 rolls of receipt paper (one roll preinstalled).

2

Power the Device

  1. Plug the device in to a power source. You can plug into a wall or a computer using the included USB power adapter.
  2. Fully charge the device before turning it on.
  3. When the device is charged, power it on by pressing and holding the small rectangle button on the right side of the device for 2 to 4 seconds.
3

Connect to WiFi

After the device boots up, it automatically launches the WSPLink app. You can’t use your own apps with the PAX device

  1. Exit the WSPLink app by pressing the top left and bottom right corners of the screen at the same time.
  2. Open the Settings app.
  3. Toggle WiFi on, then press Wi-Fi. The device will detect nearby WiFi networks.
  4. Select the network you want to connect to, enter password, and allow the device to connect.

The PAX A920 connects only to 2.4Ghz WiFi networks, and can’t connect to 5 GHz networks.

  1. Press the circle icon at the bottom of the screen to go back to the home screen.
4

Let the Device Update

After the device connects to WiFi, it will cycle through updating the embedded software. This step can take up to 15 minutes, and the device may make some noises or alerts during this process.

Don’t turn off the device, open any apps or disconnect WiFi during the update process.

When the updates have finished, the screen will be fully white.

6

Register the Device in Payabli

Now, you must register the device in Payabli before you can accept payments.

Register the device

To register a PAX A920, copy the serial number from the back of the device, and then send a request the /Cloud/register/{entry} endpoint.

POST
/api/Cloud/register/:entry
1curl -X POST https://api-sandbox.payabli.com/api/Cloud/register/8cfec329267 \
2     -H "requestToken: <apiKey>" \
3     -H "Content-Type: application/json" \
4     -d '{
5  "description": "Front Desk POS",
6  "registrationCode": "YS7DS5"
7}'

PAX A920 asynchronous flow

The PAX A920 device uses an asynchronous flow to process transactions. The transaction is initiated by the device, and the final status is sent to you in a webhook event.

1

Initiate transaction

The device sends a request to the Payabli API to process the transaction.

2

Initial response

The API responds with the current status of the transaction. The transaction isn’t complete yet.

3

Webhook response

When the transaction is complete, the API sends a webhook event to notify you of the final status of the transaction.

You must enable webhook notifications to receive them. They are not sent by default. See Set up and receive events using Web for more information.

The response for an initiated transaction looks like this:

Initiated transaction response
1{
2  "responseText": "Success",
3  "isSuccess": true,
4  "pageIdentifier": null,
5  "responseData": {
6    "authCode": null,
7    "referenceId": "237-e2928ea2f73d473f95f4094d56870ffc",
8    "resultCode": 1,
9    "resultText": "Initiated",
10    "avsResponseText": null,
11    "cvvResponseText": null,
12    "customerId": 319082,
13    "methodReferenceId": null
14  }
15}

The resultText has a value of "Initiated", which means the transaction is in progress.

To get the final status of the transaction, you need to listen for either the ApprovedPayment webhook event or the DeclinedPayment webhook event. The webhook payloads for a completed transaction look like this:

1{
2  "Event": "ApprovedPayment",
3  "Paypoint": "Athlete Factory LLC\r\n",
4  "Text": "Payment Approved!",
5  "transId": "10-33eb676a-da48-401f-9494-e69a324b152d",
6  "NetAmount": "100.00",
7  "Fee": "0.00",
8  "TotalAmount": "100.00",
9  "transTime": "04/04/2022 13:56:17",
10  "CustomerId": "224",
11  "CustomerNumber": "888"
12}

See Notifications and Reports Overview for more information on how to set up webhooks.