Intenciones de Pago

Cancelar intención de pago

DELETE /v1/cloud-terminals/payment-intentions

Permite cancelar una intención de pago previamente generada en una terminal antes de que la persona usuaria complete la transacción. Al cancelar la intención, la terminal vuelve a la pantalla de espera y queda lista para recibir una nueva solicitud.

La terminal indicada debe estar CONECTADA. Si no hay terminal conectada, la API responde 422 y no envía la cancelación.

Cuando la cancelación se liquida (EXECUTED o NOT_DELIVERED), la intención de pago relacionada pasa a CANCELLED.

Parámetros de consulta

ParámetrosDescripción
merchantId
  • (opcional)
  • string
  • Si el access_token es de un usuario CUSTOMER, se debe enviar el identificador del comercio. Si el usuario es MERCHANT no hace falta enviarlo.
terminalId
  • string
  • Identificador de la terminal
requestId
  • string
  • Identificador de la intención a cancelar: el `request_id` que devuelve el servidor al crearla
ℹ️
  • La respuesta exitosa es 204 sin body e incluye el encabezado X-API-REQUEST-ID con el request_id de la cancelación.
  • Si ya existe una cancelación para ese requestId y terminal, la respuesta es 409.
  • Para usuarios CUSTOMER y MERCHANT, un comercio o terminal inexistente o ajeno responde 403.

Encabezados

Authorization: Bearer {access_token}
curl --location --request DELETE \
  'https://api.menta.global/api/v1/cloud-terminals/payment-intentions?terminalId={terminal_id}&requestId={request_id}' \
  --header 'Authorization: Bearer {access_token}' \

204: No Content

Crear intención de pagoListar intenciones de pago