/pos
BASE URI https://api.mercadopago.com/pos
HTTP Request
curl
curl -X POST \
'https://api.mercadopago.com/pos' \
-H 'Authorization: Bearer PROD_ACCESS_TOKEN' \
-d '{
"name":"Caja Principal",
"fixed_amount": true,
"category": 621102,
"store_id": "123456",
"external_store_id": "BK021",
"external_id": "4lph4num3r1c",
"url": "https://www.miempresa.com/MP?locationId=6232&positionId=01"
}'
Request Params
ParameterTypeDescription
name
String
Nombre de la caja. (Obligatorio)
fixed_amount
Boolean
Determina si el cliente puede insertar el monto a pagar. (Obligatorio)
true
El cliente no podrá elegir el monto a pagar sino que deberá esperar la generación de una orden.
false
Luego de escanear el código QR de la caja, el cliente ingresa el monto a pagar.
category
Long
Código MCC que indica el rubro del Punto de Venta. Si no se especifica, queda como categoría genérica.
Argentina
Gastronomía - 621102
Petrolera - 473000
Petrolera - 473000
Brasil
Gastronomía - 5611203
Petrolera - 4731300
Petrolera - 4731300
Mexico
Gastronomía - 5812
Petrolera - 468419
Petrolera - 468419
Colombia
Gastronomía - 5611
Petrolera - 4731
Petrolera - 4731
Peru
Gastronomía - 5520
Petrolera - 5050
Petrolera - 5050
Uruguay
Gastronomía - 56101
Petrolera - 47300
Petrolera - 47300
Chile
Gastronomía - 561000
Petrolera - 473001
Petrolera - 473001
store_id
String
Identificador de la sucursal a la que pertenece el Punto de Venta.
external_store_id
String
External_id de la sucursal a la cual pertenece la caja, definido por el integrador. (Obligatorio)
external_id
String
Identificador único de la caja definido por el integrador.
url
String
URL para obtener la orden del sistema integrador. Es opcional y se utiliza solo en el modelo de integración desatendido.
HTTP Response
json
{
"id": 2711382,
"qr": {
"image": "https://www.mercadopago.com/instore/merchant/qr/2711382/0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png",
"template_document": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.pdf",
"template_image": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png"
},
"status": "active",
"date_created": "2019-08-22T10:11:12.000-04:00",
"date_last_updated": "2019-08-22T10:11:12.000-04:00",
"uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
"user_id": 446566691,
"name": "Caja Principal",
"fixed_amount": true,
"category": 621102,
"store_id": "12345678",
"external_store_id": "BK021",
"url": "https://www.miempresa.com/MP?locationId=6232&positionId=01",
"external_id": "4lph4num3r1c"
}
Error Codes
CodeDescription
400 BAD_REQUEST
MISSING_BODY
El body HTTP es requerido para crear cajas.
UNKNOWN_FIELD_EXCEPTION
El campo indicado no se permite para esta operación o es desconocido.
INVALID_NAME
El NAME debe ser String.
NAME_TOO_LONG
El NAME debe ser menor a 45 caracteres.
INVALID_FIXED_AMOUNT
El campo FIXED_AMOUNT debe ser Boolean.
INVALID_CATEGORY
El campo CATEGORY debe ser numérico.
UNKNOWN_MCC
El campo CATEGORY debe ser uno válido para el site del usuario.
INVALID_STORE_ID
El campo STORE_ID debe ser numérico.
INVALID_EXTERNAL_STORE_ID
El campo EXTERNAL_STORE_ID debe ser String.
EXTERNAL_STORE_ID_NOT_MATCH
El campo EXTERNAL_STORE_ID no hace referencia al STORE_ID indicado.
INEXISTENT_EXTERNAL_STORE_ID
El campo EXTERNAL_STORE_ID no hace referencia a ningún sucursal existente.
INVALID_EXTERNAL_ID
El campo EXTERNAL_ID debe ser alfanumérico, solo letras y números. Sin espacios ni guiones, ni caracteres especiales.
EXTERNAL_ID_TOO_LONG
El campo EXTERNAL_ID debe ser menor a 40 caracteres.
INVALID_URL
El campo URL debe ser String, y tener el formato de una url válida.
URL_TOO_LONG
El campo URL debe ser menor a 300 caracteres.
FIXED_AMOUNT_FALSE
Si se indica el campo URL, el campo FIXED_AMOUNT debe ser true. No soportamos la modalidad de monto abierto en este caso.
403 FORBIDDEN
1
Si estás usando el campo URL, el host de la misma tiene que estar habilitado por Mercado Pago. Si no lo está, recibirás este error. Por favor contactá a tu asesor técnico asignado.
404 NOT_FOUND
1
Si no existe el POS para un ID o EXTERNAL_ID y user indicados.
409 CONFLICT
1
Ya existe una caja con el mismo EXTERNAL_ID.