Crear terminal

post

https://api.akua.la/api/v1/terminals

Registra una nueva terminal en el sistema.

El estado inicial depende del type, integration_type y si se proporciona merchant_id:

type	integration_type	merchant_id	Estado inicial
`SOFT_POS`	`akua_app`	✓	`PENDING_ACTIVATION`
`SOFT_POS`	`akua_app`	✗	`NOT_LINKED`
`SOFT_POS`	`third_party_app` / `api_direct`	✓	`ACTIVE`
`SMART_POS`	`akua_app`	✓	`PENDING_ACTIVATION`
`SMART_POS`	`third_party_app` / `api_direct`	✓	`ACTIVE`
`POS`	`api_direct`	✓	`ACTIVE`
`POS`	`api_direct`	✗	`NOT_LINKED`

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

type

string

enum

required

Tipo de terminal.

Valor	Descripción
`SOFT_POS`	Terminal de software
`SMART_POS`	Terminal física inteligente
`POS`	Terminal POS física. Solo compatible con `integration_type: api_direct`

Allowed:

integration_type

string

enum

Defaults to akua_app

Canal de integración. Por defecto akua_app.

Valor	Descripción
`akua_app`	App de Akua
`third_party_app`	App de terceros
`api_direct`	Integración directa vía API

Allowed:

mode

string

enum

Defaults to STANDARD

Modo operativo. Solo aplica para SOFT_POS.

Valor	Descripción
`STANDARD`	El terminal inicia pagos desde el dispositivo (por defecto)
`PUSH_PAYMENT`	El terminal recibe eventos de pago desde un sistema externo

Allowed:

name

string

length ≤ 100

Nombre descriptivo de la terminal

organization_id

string

required

ID de la organización

merchant_id

string

ID del comercio. Si se proporciona, la terminal queda vinculada al crearse.

point_id

string

ID del punto de venta

model_id

string

ID del modelo de terminal (requerido para SMART_POS y POS)

serial_number

string

length ≤ 50

Número de serie del dispositivo

firmware_version

string

Versión del firmware del dispositivo

launcher_app

string

Aplicación de inicio del dispositivo

login_credentials

object

Credenciales de acceso del dispositivo (opcional).

provider

string

enum

Proveedor o fabricante del dispositivo.

Allowed:

string

length ≤ 30

ID personalizado. Si no se proporciona, se genera automáticamente.

Headers

Client-Id

string

required

Identificador del cliente

Responses

201Terminal creada exitosamente

400Solicitud malformada o con parámetros inválidos