Inicio
DocumentaciĂłn
Recursos
Partners
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integraciĂłn y vendedores que quieren contratarlos.

Comunidad

Recibe las Ășltimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Crear acciĂłn de la terminal - Impresiones - Mercado Pago Developers
Crear acciĂłn de terminal

POST

https://api.mercadopago.com/terminals/v1/actions
Este endpoint permite la creaciĂłn de una nueva acciĂłn de impresiĂłn para Mercado Pago Point. Se soporta el formato Base64 para imĂĄgenes. En caso de Ă©xito, la respuesta devolverĂĄ un cĂłdigo de estado 201.
ParĂĄmetros para la solicitud
HEADER
X-Idempotency-Key
string

REQUERIDO

Esta funciĂłn permite repetir solicitudes de manera segura, sin el riesgo de realizar la misma acciĂłn mĂĄs de una vez por error. Esto es Ăștil para evitar errores, como la creaciĂłn de dos pagos idĂ©nticos. Para garantizar qu...Ver mĂĄs
BODY
type
string

REQUERIDO

Tipo de acciĂłn asociada a la soluciĂłn de Mercado Pago para la que se crea. En estos momentos, solo se soporta el valor "print".
print: Valor asociado con la creaciĂłn de acciones de impresiĂłn para el Punto de Venta.
external_reference
string

REQUERIDO

Es una referencia externa de la acciĂłn, asignada al momento de su creaciĂłn. El lĂ­mite mĂĄximo permitido es de 64 caracteres y los permitidos son: letras mayĂșsculas y minĂșsculas, nĂșmeros y los sĂ­mbolos de guion (-) y guion...Ver mĂĄs
config
object

REQUERIDO

ConfiguraciĂłn del tipo de acciĂłn.
content
string

REQUERIDO

String que contiene la informaciĂłn a imprimir en la terminal Point. Si el subtipo es "custom", debe contener un string formateado con las etiquetas soportadas; si es "image", debe contener el contenido de la imagen en ba...Ver mĂĄs
ParĂĄmetros de respuesta
id
string
Identificador de la acciĂłn creada en la solicitud, generado automĂĄticamente por Mercado Pago.
type
string
Tipo de acciĂłn.
print: AcciĂłn de impresiĂłn creada para Point.
external_reference
string
Es una referencia externa de la acciĂłn, asignada al momento de su creaciĂłn. El lĂ­mite mĂĄximo permitido es de 64 caracteres. Los caracteres permitidos son: letras mayĂșsculas y minĂșsculas, nĂșmeros y los sĂ­mbolos de guion (...Ver mĂĄs
status
string
Estado actual de la accĂ­on.
created: La accĂ­on ha sido creada de manera exitosa.
Errores

400Error

empty_required_header

El header 'X-Idempotency-Key' es requerido y no fue enviado. Vuelve a realizar la requisición incluyéndolo.

required_properties

Ciertas propiedades requeridas estĂĄn ausentes. Chequea el mensaje devuelto en los detalles del error para saber cuĂĄl fue el problema y vuelve a intentarlo.

unsupported_properties

Se enviĂł una propiedad que no es soportada. Chequea el mensaje devuelto en los detalles del error para saber cuĂĄl fue el problema y vuelve a intentarlo.

property_type

Se enviĂł un tipo de propiedad incorrecto. Por ejemplo, un valor 'integer' para una propiedad 'string'. Chequea el mensaje devuelto en los detalles del error para saber cuĂĄl fue el problema y vuelve a intentarlo.

property_value

Se enviĂł un valor invĂĄlido para alguna propiedad. Chequea el mensaje devuelto en los detalles del error para saber cuĂĄl fue el problema y vuelve a intentarlo.

content is required

El campo content no se encuentra en el body de la peticiĂłn.

The content file size exceeds the limit 1MB

El contenido del campo content supera el peso permitido 1MB.

Error decoding base64, the provided base64 string is not valid.

El codificado de la imagen en base64 no es correcto.

401Error.

unauthorized

El valor enviado como Access Token es incorrecto. Por favor, verifĂ­calo y vuelve a intentar realizar la requisiciĂłn enviando el valor correcto.

403Error.

forbidden_checking_terminal_owner

La terminal Point no pertence al usuario que enviĂł la solicitud. Verifica si el valor enviado para "terminal_id" es correcto o si la terminal estĂĄ vinculado a tu cuenta.

409Error.

idempotency_key_already_used

El valor enviado como header de idempotencia ya fue utilizado con una solicitud distinta en un tiempo menor a 24 horas. Por favor, vuelve a intentar realizar la requisiciĂłn enviando un nuevo valor.

already_queued_order_for_terminal

La terminal ya tiene una order en espera. Es necesario finalizarla o cancelarla para enviar nuevas orders.

500Error.

idempotency_validation_failed

Falla en la validaciĂłn. Intenta enviar la solicitud nuevamente.

500

Error genérico. Intenta enviar la solicitud nuevamente.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/terminals/v1/actions'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "type": "print",
  "external_reference": "ext_ref_1234",
  "config": {
    "point": {
      "terminal_id": "NEWLAND_N950__N950NCB123456789",
      "subtype": "image"
    }
  },
  "content": "iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
}'
Respuesta de ejemplo
{
  "id": "8952c6cf-bbb4-482c-a9f2-ea5fecd3ecd2",
  "type": "print",
  "external_reference": "ext_ref_1234",
  "status": "created",
  "config": {
    "point": {
      "terminal_id": "NEWLAND_N950__N950NCB123456789",
      "subtype": "image"
    }
  }
}