v1

latestOpenAPI 3.0.32026-07-2488203535.0 KB

Devices

Create Validation Payment Request on Device

Initiate an asynchronous validation payment request on a specific cloud device. The device_id is specified in the URL path. Payment details (card number, expiration, CVV) are collected by the device itself, so they should not be included in the request body. This endpoint always operates in asynchronous mode. For synchronous payment processing with a device, use POST /api/v5/payments/validate with device_id in the request body. This endpoint uses the same underlying functionality as POST /api/v5/payments/validate.

post/v5/devices/{device_id}/payment-requests/validate

Path parameters

device_idstring required

The unique identifier of the cloud device

Request body

industry'retail' | 'restaurant' | 'ecommerce' | 'moto' | 'lodging'

Industry type for the transaction

signature_imagestring

Base64 encoded signature image

Response

Payment request created successfully

object'payment-request' required

Resource type identifier

idstring required

Payment request ID

status'pending' | 'completed' | 'error' required

Status of the payment request