Devices Quickstart

Payabli offers integrated P2PE (point-to-point encryption) cloud devices, also known as credit card terminals, that you can use to make sales via the Payabli API.

With P2PE, the device can be anywhere in the world. Data is encrypted in the device before being sent to the cloud, where it’s decrypted, processed, and returns an authorization or approval to the device.

Because the hardware devices are integrated, your employees can make card-present sales quickly and safely without manually entering cardholder data into the device and risking errors. Customers can interact with the PIN pad as needed, and can swipe, dip, or tap their cards, depending on the device.

Payabli has made setting up devices frictionless. First, order a device from Payabli, then register each new device with a single API call.

This guide gives a high-level overview of device setup and making sales using a payment cloud device (also known as credit card terminals).

​

Step 1: Register a device

If the API response is successful, you get a device identifier in the ResponseData field. Use this device identifier to make payments or store payment methods using the device.

​

Step 2: Make a transaction

Submit a payment request and include the device identifier in the field device inside the object paymentMethod and ensuring that the method field contains the value cloud.

For example, this transaction is using the device with the ID 6c361c7d-674c-44cc-b790-382b75d1xxx.

{
  "paymentMethod": {
    "method": "cloud",
    "device": "6c361c7d-674c-44cc-b790-382b75d1xxx"
  },
  "paymentDetails": {
    "totalAmount": 100
  },
  "customerData": {
    "customerId": 224,
  },
  "entryPoint": "my-entry-point"
}