API de Pricing
La API de Pricing te permite consultar todas las opciones de financiamiento y los costos asociados disponibles para tus transacciones. Esto incluye la configuración de pricing de tu cuenta virtual de PayU, como las cuotas estándar, los planes de Cuotas sin Intereses y otras características relevantes para tus clientes.
Opciones de pricing
Cada opción de pricing, ya sea un plan estándar o una promoción de Cuotas sin Intereses, incluye los medios de pago aplicables, los días de la semana en que está disponible, la lista de bancos participantes (si aplica), así como las fechas de inicio y finalización de las promociones.
La siguiente tabla muestra los países en los que están disponibles las modalidades de cuotas estándar, Cuotas sin Intereses Específicas y Cuotas sin Intereses Generales. Para obtener más información, consulta el documento de Cuotas sin Intereses.
| País | Cuotas estándar | Cuotas sin Intereses Específicas (Promociones) | Cuotas sin Intereses Generales (MSI) |
|---|---|---|---|
 Argentina |
✓ | ✓ | ✓ |
 Brasil |
✓ | ❌ | ❌ |
 Chile |
✓ | ❌ | ❌ |
 Colombia |
✓ | ✓ | ❌ |
 México |
✓ | ✓ | ✓ |
 Panamá |
✓ | ❌ | ❌ |
 Perú |
✓ | ✓ | ❌ |
Nota
Para configurar las Cuotas sin Intereses según tus acuerdos con los bancos emisores, contacta a tu representante de ventas.El siguiente diagrama muestra el flujo completo, desde la consulta a la API de Pricing hasta la aprobación de la transacción:
Autenticación para solicitudes
Para autenticar las solicitudes a la API, debes utilizar un mecanismo basado en HMAC. Necesitas tu MerchantPublicKey, que se encuentra en tu Panel de Administración de PayU en Configuración > Configuración Técnica > Llave Pública.
Configurar la autenticación
Incluye los encabezados Authorization y Date. El encabezado Authorization sigue esta estructura:
"Hmac" + " " + MerchantPublicKey + ":" + Signature
Donde Signature se crea así:
Signature = Base64(HMAC-SHA256(MerchantApiKey,ContentToSign))
Y ContentToSign corresponde a:
HTTP-Verb + "\n" + "\n" + "\n" +
Date + "\n" +
URI
Nota
Es obligatorio incluir tres saltos de línea (\n) luego de HTTP-Verb.
Ejemplo: Generar el encabezado de autenticación
Los siguientes ejemplos muestran cómo crear el encabezado de Autenticación utilizando los siguientes valores de prueba:
ContentToSign:
GET
Fri, 28 Apr 2017 18:32:01 GMT
/payments-api/rest/v4.9/pricing
MerchantApiKey:
4Vj8eK4rloUd272L48hsrarnUA
MerchantPublicKey:
PKaC6H4cEDJD919n705L544kSU
Encripta el ContentToSign utilizando MerchantApiKey como frase de contraseña. Luego, concatena el resultado con el MerchantPublicKey como se muestra a continuación:
Authorization
Hmac PKaC6H4cEDJD919n705L544kSU:sIxh54sANfKaxO0ugX6QwhPmZRS+TGy8gmdCwr3kjP0=
Para evitar ataques de repetición, envía el encabezado Date siguiendo este formato:
Date
Mon, 11 May 2015 21:14:41 GMT
Si las restricciones del cliente REST impiden el uso de Date, puedes enviar alternativamente x-hmac-date utilizando el mismo formato:
x-hmac-date
Mon, 11 May 2015 21:14:41 GMT
Consultar los planes de Cuotas sin Intereses disponibles
Para obtener los planes de Cuotas sin Intereses, envía una solicitud GET a la URL correspondiente según el entorno.
Endpoints de la API
- Pruebas:
GET https://sandbox.api.payulatam.com/payments-api/rest/v4.9/pricing - Producción:
GET https://api.payulatam.com/payments-api/rest/v4.9/pricing
Dado que este es un servicio RESTful, recomendamos enfáticamente no aplicar una validación estricta del esquema. Evitar la validación del esquema garantiza una integración sin inconvenientes y minimiza los cambios cuando se actualiza el servicio web.
Parámetros para la solicitud y respuesta
Parámetros de la solicitud
| Parámetro | Descripción | Obligatorio |
|---|---|---|
accountId |
Identificador único de tu cuenta. | Sí |
currency |
Moneda asociada a tu cuenta. | No |
amount |
Monto total de la compra. | Sí |
paymentMethod |
Parámetro opcional para filtrar promociones por método de pago. | No |
tax |
Monto del impuesto incluido en la transacción. Aplica solo en Argentina y Colombia. | No |
taxReturnBase |
Valor base utilizado para calcular el impuesto. Aplica solo en Argentina y Colombia. | No |
Parámetros de la respuesta
| Nombre del Campo | Tipo | Descripción |
|---|---|---|
amount |
Objeto | Detalles del monto de la transacción. |
amount > value |
Número | Valor total de la transacción. |
amount > tax |
Número | Monto de impuestos incluidos en la transacción. |
amount > purchaseValue |
Número | Valor de la compra antes de impuestos. |
amount > adminFeeValue |
Número | Valor de la comisión administrativa incluida en la transacción. |
amount > adminFeeTax |
Número | Monto de impuestos aplicables a la comisión administrativa. |
amount > adminFeeTaxableBase |
Número | Base imponible utilizada para calcular los impuestos sobre la comisión administrativa. |
amount > currency |
String | Código de moneda de la transacción original. |
amount > taxableBase |
Número | Valor de la transacción utilizado como base para el cálculo de impuestos. |
convertedAmount |
Objeto | Contiene el monto de la transacción convertido a otra moneda (si aplica). |
convertedAmount > value |
Número | Valor total convertido de la transacción. |
convertedAmount > tax |
Número | Monto de impuestos convertido. |
convertedAmount > purchaseValue |
Número | Valor de compra convertido antes de impuestos. |
convertedAmount > adminFeeValue |
Número | Valor convertido de la comisión administrativa. |
convertedAmount > adminFeeTaxableBase |
Número | Base imponible convertida para el cálculo de impuestos sobre la comisión administrativa. |
convertedAmount > currency |
String | Código de moneda del monto convertido. |
convertedAmount > taxableBase |
Número | Valor convertido utilizado como base para el cálculo de impuestos. |
paymentMethodFee |
Lista | Contiene el desglose de costos asumidos por el comercio según el medio de pago. |
paymentMethodFee > paymentMethod |
String | Nombre del medio de pago. |
paymentMethodFee > pricingFees |
Objeto | Contiene los detalles de precios por medio de pago y rango de cuotas. |
paymentMethodFee > pricingFees > installments |
String | Número de cuotas, ya sea un único valor (por ejemplo, 1) o, en países aplicables, un rango (por ejemplo, 1-36). |
paymentMethodFee > pricingFees > pricing |
Objeto | Contiene los detalles de precios para la transacción. |
paymentMethodFee > pricingFees > pricing > payerDetail |
Objeto | Desglose de intereses y comisiones cobradas al pagador. |
paymentMethodFee > pricingFees > pricing > payerDetail > commission |
Número | Monto total de comisiones (incluyendo impuestos) cobradas al pagador. |
paymentMethodFee > pricingFees > pricing > payerDetail > interests |
Número | Monto total de intereses (incluyendo impuestos) cobrados al pagador. |
paymentMethodFee > pricingFees > pricing > payerDetail > total |
Número | Monto total a pagar por el pagador, incluyendo intereses y comisiones. |
paymentMethodFee > pricingFees > pricing > merchantDetail |
Objeto | Desglose de intereses y comisiones cobradas al comercio. |
paymentMethodFee > pricingFees > pricing > merchantDetail > commission |
Número | Monto total de comisiones (incluyendo impuestos) cobradas al comercio. |
paymentMethodFee > pricingFees > pricing > merchantDetail > interests |
Número | Monto total de intereses (incluyendo impuestos) cobrados al comercio. |
paymentMethodFee > pricingFees > pricing > merchantDetail > total |
Número | Costo total asumido por el comercio, incluyendo intereses y comisiones. |
paymentMethodFee > pricingFees > pricing > totalValue |
Número | Valor total de la transacción incluyendo intereses y comisiones. |
paymentMethodFee > pricingFees > pricing > totalIncomeTransaction |
Número | Ingreso total generado por la transacción. |
paymentMethodFee > pricingFees > pricing > additionalInfo |
Objeto | Incluye información financiera como la Tasa Efectiva Anual (TEA) y el Costo Financiero Total (CFT). Aplica solo para Argentina. |
paymentMethodFee > pricingFees > pricing > additionalInfo > cft |
Número | Costo Financiero Total (CFT) aplicado a la transacción. |
paymentMethodFee > pricingFees > pricing > additionalInfo > tea |
Número | Tasa Efectiva Anual (TEA) aplicada a la transacción. |
paymentMethodFee > pricingFees > promos |
Array | Lista de promociones disponibles aplicables a la configuración de precios. |
paymentMethodFee > pricingFees > promos > id |
Entero | Identificador único de la promoción en el sistema PayU. |
paymentMethodFee > pricingFees > promos > pricing |
Objeto | Contiene los detalles de precios para la promoción específica. |
paymentMethodFee > pricingFees > promos > pricing > payerDetail |
Objeto | Desglose de intereses y comisiones para el pagador bajo la promoción. |
paymentMethodFee > pricingFees > promos > pricing > payerDetail > commission |
Número | Monto de comisión cobrado al pagador bajo la promoción. |
paymentMethodFee > pricingFees > promos > pricing > payerDetail > interests |
Número | Monto de intereses cobrado al pagador bajo la promoción. |
paymentMethodFee > pricingFees > promos > pricing > payerDetail > total |
Número | Monto total a pagar por el pagador, incluyendo comisiones e intereses, bajo la promoción. |
paymentMethodFee > pricingFees > promos > pricing > merchantDetail |
Objeto | Desglose de intereses y comisiones para el comercio bajo la promoción. |
paymentMethodFee > pricingFees > promos > pricing > merchantDetail > commission |
Número | Monto de comisión cobrado al comercio bajo la promoción. |
paymentMethodFee > pricingFees > promos > pricing > merchantDetail > interests |
Número | Monto de intereses cobrado al comercio bajo la promoción. |
paymentMethodFee > pricingFees > promos > pricing > merchantDetail > total |
Número | Costo total para el comercio, incluyendo comisiones e intereses, bajo la promoción. |
paymentMethodFee > pricingFees > promos > pricing > totalValue |
Número | Valor total de la transacción con comisiones e intereses bajo la promoción. |
paymentMethodFee > pricingFees > promos > pricing > totalIncomeTransaction |
Número | Ingreso total generado por la transacción bajo la promoción. |
paymentMethodFee > pricingFees > promos > priority |
Número | Nivel de prioridad de la promoción dentro de la configuración de precios. |
promotions |
Objeto | Contiene detalles sobre la promoción aplicada (si corresponde). |
promotions > id |
Entero | Identificador único de la promoción en el sistema PayU. |
promotions > title |
String | Título de la promoción (máximo 50 caracteres). |
promotions > termsAndConditions |
String | Términos y condiciones aplicables a la promoción (máximo 250 caracteres). |
promotions > paymentMethod |
String | Medio de pago asociado a la promoción. |
promotions > subFranchise |
String | Submarca o sub-franquicia asociada a la promoción. |
promotions > banksNames |
Lista | Lista de bancos donde aplica la promoción. |
promotions > paymentMethodMain |
String | Medio de pago principal asociado a la promoción. |
promotions > iin |
Lista | Lista de números IIN/BIN de tarjetas elegibles para la promoción. |
promotions > days |
Lista | Días de la semana en los que está disponible la promoción. |
promotions > startDate |
Fecha y hora | Fecha y hora de inicio de la promoción. |
promotions > endDate |
Fecha y hora | Fecha y hora de finalización de la promoción. |
promotions > priority |
Número | Nivel de prioridad de la promoción. |
promotions > type |
String | Tipo de promoción. Los valores posibles son: PRICING – La promoción se aplica automáticamente según las reglas de precios configuradas. Por ejemplo, en México, si se configuran cuotas sin interés, el comercio solo debe enviar el número de cuotas en transaction > extraParameters > INSTALLMENTS_NUMBER. El sistema aplicará automáticamente la condición sin interés sin requerir un ID de promoción.MSI – Requiere que el comercio envíe explícitamente tanto el ID de la promoción como el número de cuotas. Esto aplica cuando la promoción debe coincidir con una combinación específica de medio de pago, cuotas e ID de promoción. Para aplicar este tipo, deben enviarse los siguientes campos: - transaction > extraParameters > INSTALLMENTS_NUMBER- transaction > extraParameters > PROMOTION_IDNota: Si no se envía el ID de promoción cuando es requerido, la transacción se procesará sin la promoción, utilizando la configuración de precios predeterminada disponible para la opción de cuotas seleccionada. |
paymentTaxesDetails |
Objeto | Contiene los detalles de los impuestos aplicados (estructura depende de la respuesta del servicio de impuestos). |
taxesServiceFailed |
Booleano | Indica si falló el servicio de cálculo de impuestos. |
Llamado a la API
Para obtener los planes de Cuotas sin Intereses disponibles, envía una solicitud GET con el siguiente formato:
GET
https://{env-api}.payulatam.com/payments-api/rest/v4.9/pricing?accountId={accountId}¤cy={currency}&amount={amount}&paymentMethod={paymentMethod}
Accept: application/json
Content-Type: application/json
Authorization: Hmac PKaC6H4cEDJD919n705L544kSU:sIxh54sANfKaxO0ugX6QwhPmZRS+TGy8gmdCwr3kjP0=
Date: Fri, 16 May 2025 14:37:05 GMT
La variable {env-api} debe configurarse de la siguiente manera:
sandbox.apipara pruebasapipara producción
El parámetro paymentMethod es opcional y puede utilizarse para filtrar promociones por un método de pago específico. Los parámetros tax y taxReturnBase también son opcionales, pero solo aplican en Argentina y Colombia.
Ejemplo de solicitud para Argentina:
https://sandbox.api.payulatam.com/payments-api/rest/v4.9/pricing?accountId=512322¤cy=ARS&amount=110524.91&tax=19182.01&taxReturnBase=91342.90
Ejemplo de solicitud para Colombia:
https://sandbox.api.payulatam.com/payments-api/rest/v4.9/pricing?accountId=512321¤cy=COP&amount=11601.71&tax=1769.75&taxReturnBase=9831.96
Ejemplo de solicitud para México:
https://sandbox.api.payulatam.com/payments-api/rest/v4.9/pricing?accountId=512324¤cy=MXN&amount=15662.37
Ejemplo de solicitud para Perú:
https://sandbox.api.payulatam.com/payments-api/rest/v4.9/pricing?accountId=516634¤cy=PEN&amount=2897.78
Ejemplo de una respuesta:
{
"amount": {
"value": 1000.00,
"tax": 0,
"purchaseValue": 1000.00,
"currency": "ARS"
},
"convertedAmount": {
"value": 1000.00,
"tax": 0.00,
"purchaseValue": 1000.00,
"currency": "ARS"
},
"promotions": [
{
"id": 49,
"title": "Promotion_ID AMEX",
"termsAndConditions": "SI",
"paymentMethodMain": "AMEX",
"startDate": "2018-08-16 18:48:00",
"endDate": "2090-08-16 18:48:00",
"days": [
"MONDAY",
"TUESDAY",
"WEDNESDAY",
"THURSDAY",
"FRIDAY",
"SATURDAY",
"SUNDAY"
],
"priority": 10,
"type": "MSI"
},
{
"id": 45,
"title": "Promotion Test - Master",
"termsAndConditions": "Terminos y condiciones",
"paymentMethodMain": "MASTERCARD",
"startDate": "2018-06-26 17:06:00",
"endDate": "2030-06-26 17:06:00",
"days": [
"MONDAY",
"TUESDAY",
"WEDNESDAY",
"THURSDAY",
"FRIDAY",
"SATURDAY",
"SUNDAY"
],
"priority": 10,
"type": "MSI"
}
],
"paymentMethodFee": [
{
"paymentMethod": "DINERS",
"pricingFees": [
{
"installments": "1",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 0.00,
"total": 0.00
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1000.00,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "0%",
"tea": "0%"
}
}
},
{
"installments": "3",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 171.29,
"total": 171.29
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1171.29,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "162%",
"tea": "123.28%"
}
}
},
{
"installments": "6",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 230.01,
"total": 230.01
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1230.01,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "107%",
"tea": "83.97%"
}
}
},
{
"installments": "9",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 340.05,
"total": 340.05
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1340.04,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "108%",
"tea": "85.03%"
}
}
},
{
"installments": "12",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 490.01,
"total": 490.01
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1490.02,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "119%",
"tea": "93.68%"
}
}
},
{
"installments": "18",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 641.38,
"total": 641.38
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1641.39,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "97%",
"tea": "77.91%"
}
}
},
{
"installments": "24",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 822.72,
"total": 822.72
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1822.72,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "90%",
"tea": "72.47%"
}
}
}
]
},
{
"paymentMethod": "AMEX",
"pricingFees": [
{
"installments": "1",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 0.00,
"total": 0.00
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1000.00,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "0%",
"tea": "0%"
}
},
"promos": [
{
"id": 49,
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 0.00,
"total": 0.00
},
"merchantDetail": {
"commission": 1044.65,
"interests": 0.00,
"total": 1044.65
},
"totalValue": 1000.00,
"totalIncomeTransaction": -44.65,
"additionalInfo": {
"cft": "0%",
"tea": "0%"
}
},
"priority": 10
}
]
},
{
"installments": "3",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 171.29,
"total": 171.29
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1171.29,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "162%",
"tea": "123.28%"
}
}
},
{
"installments": "6",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 230.01,
"total": 230.01
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1230.01,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "107%",
"tea": "83.97%"
}
}
},
{
"installments": "9",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 340.05,
"total": 340.05
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1340.04,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "108%",
"tea": "85.03%"
}
}
},
{
"installments": "12",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 490.01,
"total": 490.01
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1490.02,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "119%",
"tea": "93.68%"
}
}
},
{
"installments": "18",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 641.38,
"total": 641.38
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1641.39,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "97%",
"tea": "77.91%"
}
}
},
{
"installments": "24",
"pricing": {
"payerDetail": {
"commission": 0.00,
"interests": 822.72,
"total": 822.72
},
"merchantDetail": {
"commission": 44.65,
"interests": 0.00,
"total": 44.65
},
"totalValue": 1822.72,
"totalIncomeTransaction": 955.35,
"additionalInfo": {
"cft": "90%",
"tea": "72.47%"
}
}
}
]
}
],
"paymentTaxesDetails": [],
"taxesServiceFailed": true
}
<consultPriceListResponse xmlns:atom="http://www.w3.org/2005/Atom" xmlns:ns3="http://wadl.dev.java.net/2009/02">
<amount>
<value>1000.00</value>
<tax>0</tax>
<purchaseValue>1000.00</purchaseValue>
<currency>ARS</currency>
</amount>
<convertedAmount>
<value>1000.00</value>
<tax>0.00</tax>
<purchaseValue>1000.00</purchaseValue>
<currency>ARS</currency>
</convertedAmount>
<promotions>
<promotion id="49" title="Promotion_ID AMEX">
<priority>10</priority>
<type>MSI</type>
<paymentMethod>AMEX</paymentMethod>
<termsAndConditions>SI</termsAndConditions>
<startDate>2018-08-16 18:48:00</startDate>
<endDate>2090-08-16 18:48:00</endDate>
<days>
<day>MONDAY</day>
<day>TUESDAY</day>
<day>WEDNESDAY</day>
<day>THURSDAY</day>
<day>FRIDAY</day>
<day>SATURDAY</day>
<day>SUNDAY</day>
</days>
</promotion>
<promotion id="45" title="Promotion Test - Master">
<priority>10</priority>
<type>MSI</type>
<paymentMethod>MASTERCARD</paymentMethod>
<termsAndConditions>Terminos y condiciones</termsAndConditions>
<startDate>2018-06-26 17:06:00</startDate>
<endDate>2030-06-26 17:06:00</endDate>
<days>
<day>MONDAY</day>
<day>TUESDAY</day>
<day>WEDNESDAY</day>
<day>THURSDAY</day>
<day>FRIDAY</day>
<day>SATURDAY</day>
<day>SUNDAY</day>
</days>
</promotion>
</promotions>
<paymentMethodFee>
<paymentMethodFeeDetail paymentMethod="DINERS">
<pricingFees>
<fee installments="1">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>0.00</interests>
<total>0.00</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1000.00</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>0%</value>
</entry>
<entry>
<key>tea</key>
<value>0%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="3">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>171.29</interests>
<total>171.29</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1171.29</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>162%</value>
</entry>
<entry>
<key>tea</key>
<value>123.28%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="6">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>230.01</interests>
<total>230.01</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1230.01</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>107%</value>
</entry>
<entry>
<key>tea</key>
<value>83.97%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="9">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>340.05</interests>
<total>340.05</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1340.04</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>108%</value>
</entry>
<entry>
<key>tea</key>
<value>85.03%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="12">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>490.01</interests>
<total>490.01</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1490.02</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>119%</value>
</entry>
<entry>
<key>tea</key>
<value>93.68%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="18">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>641.38</interests>
<total>641.38</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1641.39</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>97%</value>
</entry>
<entry>
<key>tea</key>
<value>77.91%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="24">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>822.72</interests>
<total>822.72</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1822.72</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>90%</value>
</entry>
<entry>
<key>tea</key>
<value>72.47%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
</pricingFees>
</paymentMethodFeeDetail>
<paymentMethodFeeDetail paymentMethod="AMEX">
<pricingFees>
<fee installments="1">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>0.00</interests>
<total>0.00</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1000.00</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>0%</value>
</entry>
<entry>
<key>tea</key>
<value>0%</value>
</entry>
</additionalInfo>
</pricing>
<promos>
<promo id="49">
<priority>10</priority>
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>0.00</interests>
<total>0.00</total>
</payerDetail>
<merchantDetail>
<commission>1044.65</commission>
<interests>0.00</interests>
<total>1044.65</total>
</merchantDetail>
<totalValue>1000.00</totalValue>
<totalIncomeTransaction>-44.65</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>0%</value>
</entry>
<entry>
<key>tea</key>
<value>0%</value>
</entry>
</additionalInfo>
</pricing>
</promo>
</promos>
</fee>
<fee installments="3">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>171.29</interests>
<total>171.29</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1171.29</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>162%</value>
</entry>
<entry>
<key>tea</key>
<value>123.28%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="6">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>230.01</interests>
<total>230.01</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1230.01</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>107%</value>
</entry>
<entry>
<key>tea</key>
<value>83.97%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="9">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>340.05</interests>
<total>340.05</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1340.04</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>108%</value>
</entry>
<entry>
<key>tea</key>
<value>85.03%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="12">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>490.01</interests>
<total>490.01</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1490.02</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>119%</value>
</entry>
<entry>
<key>tea</key>
<value>93.68%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="18">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>641.38</interests>
<total>641.38</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1641.39</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>97%</value>
</entry>
<entry>
<key>tea</key>
<value>77.91%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
<fee installments="24">
<pricing>
<payerDetail>
<commission>0.00</commission>
<interests>822.72</interests>
<total>822.72</total>
</payerDetail>
<merchantDetail>
<commission>44.65</commission>
<interests>0.00</interests>
<total>44.65</total>
</merchantDetail>
<totalValue>1822.72</totalValue>
<totalIncomeTransaction>955.35</totalIncomeTransaction>
<additionalInfo>
<entry>
<key>cft</key>
<value>90%</value>
</entry>
<entry>
<key>tea</key>
<value>72.47%</value>
</entry>
</additionalInfo>
</pricing>
</fee>
</pricingFees>
</paymentMethodFeeDetail>
</paymentMethodFee>
<paymentTaxesDetails/>
<taxesServiceFailed>true</taxesServiceFailed>
</consultPriceListResponse>
Procesamiento de transacciones con cuotas
La siguiente tabla resume las opciones de cuotas, los campos requeridos y cómo se gestionan los intereses en cada caso.
| Tipo de cuotas | Parámetros requeridos | ¿Quién asume los intereses? | Notas |
|---|---|---|---|
| Cuotas Estándar | INSTALLMENTS_NUMBER |
Pagador | Valor predeterminado si no se envía PROMOTION_ID y el pricing no activa MSI. |
| Cuotas sin Intereses Específicas | PROMOTION_ID, INSTALLMENTS_NUMBER |
Comercio | Utiliza un acuerdo promocional específico. |
| Cuotas sin Intereses Generales (MSI) | INSTALLMENTS_NUMBER |
Comercio | La configuración de MSI debe estar habilitada en la cuenta del comercio. |
Consideraciones:
-
Si solo se envía
INSTALLMENTS_NUMBERy MSI no está activo, la transacción se procesa como cuotas estándar y se le cobrará interés al pagador. -
Para asegurar que se apliquen Cuotas sin Intereses, siempre verifica si tu cuenta tiene habilitado MSI o si estás usando una promoción específica.
Realizar una transacción con Cuotas sin Intereses
Una vez que hayas seleccionado un plan de Cuotas sin Intereses, incluye el PROMOTION_ID y el INSTALLMENTS_NUMBER como parámetros adicionales en tu solicitud:
"extraParameters": {
"INSTALLMENTS_NUMBER": (número de cuotas),
"PROMOTION_ID": (ID de la promoción seleccionada)
}
<extraParameters>
<entry>
<string>INSTALLMENTS_NUMBER</string>
<string>Número de cuotas</string>
</entry>
<entry>
<string>PROMOTION_ID</string>
<string>ID de la promoción seleccionada</string>
</entry>
</extraParameters>
Nota
Para más detalles sobre la inclusión de estos parámetros adicionales, consulta la documentación correspondiente de la API de Pagos para tu país:
MSI - Meses Sin Intereses
En México, las Cuotas sin Intereses Generales se conocen comúnmente como Meses sin Intereses (MSI). Esta modalidad permite ofrecer planes de pago fijos (3, 6, 9, 12 o 18 meses) sin intereses, sin necesidad de consultar el ID de una promoción.
Consideraciones
- Opciones de cuotas disponibles: 3, 6, 9, 12 o 18 meses.
- Montos mínimos de compra requeridos para MSI:
- 3 meses → $300 MXN
- 6 meses → $600 MXN
- 9 meses → $900 MXN
- 12 meses → $1200 MXN
- 18 meses → $1800 MXN
- MSI está disponible con los siguientes bancos: BANAMEX, BANCO REGIONAL DE MONTERREY S.A, BANCOPPEL, BANCO AZTECA, SCOTIABANK, HSBC, INBURSA, BANCA MIFEL SA, BANCO MULTIVA, BAJÍO, CI BANCO, Afirme, Banregio, Banjercito, Banorte, Famsa, Invex, Premium Card Liverpool, Santander y Bancomer.
- Al usar la promoción, muestra siempre la frase MESES SIN INTERESES durante el proceso de pago. Para cuotas estándar (sin promoción), usa PAGOS DIFERIDOS.
Nota
Para habilitar los planes MSI en tu cuenta, contacta a tu representante de ventas.Parámetros de solicitud para MSI
Para aplicar MSI, incluye el número de meses en el campo extraParameters:
"extraParameters": {
"INSTALLMENTS_NUMBER": (número de meses)
}
<extraParameters>
<entry>
<string>INSTALLMENTS_NUMBER</string>
<string>Número de meses</string>
</entry>
</extraParameters>
Para más detalles sobre el uso de MSI, consulta la API de Pagos de México.
Última modificación
13 de agosto de 2025:
Documentation updates (8294be065)