HomeGuíasAPI ReferenceChangelog
Log In
API Reference

Registrar un terminal POS

Registra un terminal POS para la cuenta de las credenciales de la petición.

El adquirente (gateway) queda fijo al registrarlo: los cobros que corran en ese dispositivo van a ese adquirente, sin elegirlo en cada venta. Cada adquirente exige sus propios datos (Getnet, por ejemplo, exige acquirer_commerce_code y acquirer_branch_id), y una petición sin ellos, o con un adquirente que no cobra por POS, se rechaza con 422.

Un dispositivo ya registrado responde 409, nunca reutiliza el registro anterior. Si el terminal fue eliminado, se puede volver a registrar.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required

Código de país (ISO alpha-2 en minúsculas) que acota la operación.

Allowed:
Body Params

Datos con que se registra un terminal POS.

string
length ≤ 32

Código de la sucursal del adquirente donde está el terminal.

string
length ≤ 32

Código de comercio del adquirente al que responde el terminal.

string
length ≤ 32

Número de serie del dispositivo físico.

string
enum
required

Adquirente del terminal. Queda fijo al registrarlo y es el que cobra en ese dispositivo.

string
required
length ≤ 32

Identificador del terminal en el adquirente, el mismo que imprime el voucher.

string
enum
Defaults to SMART_POS

Tipo de dispositivo. Se declara al registrarlo y después no cambia.

Allowed:
Headers
string

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Responses

422

El adquirente no cobra por POS, o faltan los datos que exige: detail trae el texto que lo explica. Un cuerpo que no cumple el esquema responde el mismo estado con la lista de errores de validación en detail.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json