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)
| Campo | Tipo | Oblig. | Descripció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 | string | — | CREDIT o DEBIT. |
| card_brand | string | — | Marca de la tarjeta (VISA, MASTERCARD, etc.). |
| installments | integer | — | Número de cuotas. Si no aplica, enviar 1. |
| additional_info | string | — | Texto opcional visible en reportes/recibos. |
| is_tip_allowed | boolean | — | Permite agregar propina en la terminal. (Por defecto es true) |
| is_print_allowed | boolean | — | Habilita impresión de comprobante en la terminal. (Por defecto es 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
{}