Intenciones de Pago

Crear intención de pago

POST /cloud-terminals/payment-intentions

Permite crear una nueva intención de pago sobre una terminal física del ecosistema Menta. Al invocarlo se envía el importe y la información del comercio a la terminal para que la persona usuaria confirme la compra. No realiza el cobro inmediato; simplemente prepara la transacción en la terminal.

ℹ️

Usá un identificador idempotente x-app-request-id (UUID v4) y conservá su valor para reintentos o cancelaciones.

Encabezados

Authorization: Bearer {access_token}

Body (JSON)

ParámetrosDescripción
customer_id
  • string
  • Identificador del cliente provisto por Menta
merchant_id
  • string
  • Identificador del comercio
terminal_id
  • string
  • Identificador de la terminal donde se realizará el cobro
amount
  • string
  • Importe a cobrar; decimales con punto
payment_method
  • (opcional)
  • string
  • CREDIT o DEBIT
  • [CREDIT,DEBIT]
card_brand
  • (opcional)
  • string
  • Marca de la tarjeta (VISA, MASTERCARD, etc.)
installments
  • (opcional)
  • integer
  • Número de cuotas. Si no aplica, enviar 1
additional_info
  • (opcional)
  • string
  • Texto opcional visible en reportes/recibos
is_tip_allowed
  • (opcional)
  • boolean
  • Permite agregar propina en la terminal. Por defecto: true
is_print_allowed
  • (opcional)
  • boolean
  • Habilita impresión de comprobante en la terminal. Por defecto: true
curl --location --request POST 'https://api.menta.global/api/v1/cloud-terminals/payment-intentions' \
  --header 'Authorization: Bearer {access_token}' \
  --data-raw '{
    "customer_id": "{customer_id}",
    "merchant_id": "{merchant_id}",
    "terminal_id": "{terminal_id}",
    "amount": "1000.00",
    "payment_method": "CREDIT",
    "card_brand": "VISA",
    "installments": 3,
    "additional_info": "Compra en restaurante - Mesa 5",
    "is_tip_allowed": true,
    "is_print_allowed": true
  }'

201: Created

{}