API de Pricing
A API de Pricing permite consultar todas as opções de parcelamento disponíveis e os custos associados para suas transações. Isso inclui a configuração de preços da sua conta virtual PayU, como parcelamentos padrão, planos de Parcelamento sem Juros e outros recursos relevantes para seus clientes.
Opções de pricing
Cada opção de pricing, seja um plano padrão ou uma promoção com Parcelamento sem Juros, inclui os métodos de pagamento aplicáveis, os dias da semana em que está disponível, a lista de bancos participantes (se aplicável), bem como as datas de início e término das promoções.
A tabela a seguir mostra os países onde estão disponíveis os parcelamentos padrão, os Parcelamentos sem Juros Específicos e os Parcelamentos sem Juros Gerais (MSI). Para mais informações, consulte o documento Parcelamento sem Juros.
| País | Parcelamento Padrão | Parcelamento sem Juros Específico (Promoções) | Parcelamento sem Juros Geral (MSI) |
|---|---|---|---|
 Argentina |
✓ | ✓ | ✓ |
 Brasil |
✓ | ❌ | ❌ |
 Chile |
✓ | ❌ | ❌ |
 Colômbia |
✓ | ✓ | ❌ |
 México |
✓ | ✓ | ✓ |
 Panamá |
✓ | ❌ | ❌ |
 Peru |
✓ | ✓ | ❌ |
Nota
Para configurar os Parcelamentos sem Juros de acordo com seus acordos com os bancos emissores, entre em contato com seu representante de vendas.O diagrama a seguir mostra o fluxo completo, desde a consulta à API de Pricing até a aprovação da transação:
Autenticação para requisições
Para autenticar as requisições da API, é necessário usar um mecanismo baseado em HMAC. Você precisa da sua MerchantPublicKey, que pode ser encontrada no seu Painel de Gerenciamento PayU em Configuração > Configuração técnica > Chave pública.
Configuração da autenticação
Inclua os cabeçalhos Authorization e Date na sua requisição. O cabeçalho Authorization segue esta estrutura:
"Hmac" + " " + MerchantPublicKey + ":" + Signature
Onde Signature é criada da seguinte forma:
Signature = Base64(HMAC-SHA256(MerchantApiKey,ContentToSign))
E ContentToSign corresponde a:
HTTP-Verb + "\n" + "\n" + "\n" +
Date + "\n" +
URI
Observação
É obrigatório incluir as três quebras de linha (\n) depois de HTTP-Verb.
Exemplo: Gerando o cabeçalho de autenticação
O seguinte exemplo mostra como criar o cabeçalho de Autenticação usando os seguintes valores de teste:
ContentToSign:
GET
Fri, 28 Apr 2017 18:32:01 GMT
/payments-api/rest/v4.9/pricing
MerchantApiKey:
4Vj8eK4rloUd272L48hsrarnUA
MerchantPublicKey:
PKaC6H4cEDJD919n705L544kSU
Criptografe ContentToSign usando MerchantApiKey como senha. Em seguida, concatene o resultado com MerchantPublicKey como mostrado abaixo:
Authorization
Hmac PKaC6H4cEDJD919n705L544kSU:sIxh54sANfKaxO0ugX6QwhPmZRS+TGy8gmdCwr3kjP0=
Para evitar ataques de repetção (replay attacks), inclua o cabeçalho Date formatado da seguinte forma:
Date
Mon, 11 May 2015 21:14:41 GMT
Se restrições do cliente REST impedirem o uso de Date, você pode alternativamente enviar x-hmac-date no mesmo formato:
x-hmac-date
Mon, 11 May 2015 21:14:41 GMT
Consultar os planos de Parcelamento sem Juros disponíveis
Para recuperar promoções, envie uma requisição GET para a URL apropriada com base no ambiente.
Endpoints da API
- Teste:
GET https://sandbox.api.payulatam.com/payments-api/rest/v4.9/pricing - Produção:
GET https://api.payulatam.com/payments-api/rest/v4.9/pricing
Como este é um serviço RESTful, recomendamos fortemente evitar a validação estrita do esquema. Evitar a validação do esquema garante uma integração mais suave, minimizando mudanças quando atualizações são feitas no Web Service.
Parâmetros da requisição e resposta
Parâmetros da requisição
| Parâmetro | Descrição | Obrigatório |
|---|---|---|
accountId |
Identificador único da sua conta. | Sim |
currency |
Moeda associada à sua conta. | Não |
amount |
Valor total da compra. | Sim |
paymentMethod |
Parâmetro opcional para filtrar promoções por meio de pagamento. | Não |
tax |
Valor do imposto incluído na transação. Aplicável apenas na Argentina e na Colômbia. | Não |
taxReturnBase |
Valor base utilizado para calcular o imposto. Aplicável apenas na Argentina e na Colômbia. | Não |
Parâmetros de resposta
| Nome do Campo | Tipo | Descrição |
|---|---|---|
amount |
Objeto | Detalhes do valor da transação. |
amount > value |
Número | Valor total da transação. |
amount > tax |
Número | Valor dos impostos incluídos na transação. |
amount > purchaseValue |
Número | Valor da compra antes dos impostos. |
amount > adminFeeValue |
Número | Valor da taxa administrativa incluída na transação. |
amount > adminFeeTax |
Número | Valor do imposto aplicado à taxa administrativa. |
amount > adminFeeTaxableBase |
Número | Base tributável usada para calcular impostos sobre a taxa administrativa. |
amount > currency |
String | Código da moeda da transação original. |
amount > taxableBase |
Número | Valor da transação utilizado como base de cálculo para impostos. |
convertedAmount |
Objeto | Contém o valor da transação convertido para outra moeda (se aplicável). |
convertedAmount > value |
Número | Valor total convertido da transação. |
convertedAmount > tax |
Número | Valor convertido dos impostos. |
convertedAmount > purchaseValue |
Número | Valor convertido da compra antes dos impostos. |
convertedAmount > adminFeeValue |
Número | Valor convertido da taxa administrativa. |
convertedAmount > adminFeeTaxableBase |
Número | Base tributável convertida para cálculo de impostos sobre a taxa administrativa. |
convertedAmount > currency |
String | Código da moeda do valor convertido. |
convertedAmount > taxableBase |
Número | Valor convertido utilizado como base de cálculo para impostos. |
paymentMethodFee |
Lista | Detalhamento dos custos incorridos pelo lojista com base no meio de pagamento. |
paymentMethodFee > paymentMethod |
String | Nome do meio de pagamento. |
paymentMethodFee > pricingFees |
Objeto | Contém os detalhes de precificação por meio de pagamento e faixa de parcelas. |
paymentMethodFee > pricingFees > installments |
String | Número de parcelas, valor único (ex.: 1) ou faixa (ex.: 1-36). |
paymentMethodFee > pricingFees > pricing |
Objeto | Contém os detalhes de precificação da transação. |
paymentMethodFee > pricingFees > pricing > payerDetail |
Objeto | Detalhamento dos juros e taxas cobrados do pagador. |
paymentMethodFee > pricingFees > pricing > payerDetail > commission |
Número | Valor total da comissão (com impostos) cobrada do pagador. |
paymentMethodFee > pricingFees > pricing > payerDetail > interests |
Número | Valor total dos juros (com impostos) cobrados do pagador. |
paymentMethodFee > pricingFees > pricing > payerDetail > total |
Número | Valor total a ser pago pelo pagador, incluindo juros e taxas. |
paymentMethodFee > pricingFees > pricing > merchantDetail |
Objeto | Detalhamento dos juros e taxas cobrados do lojista. |
paymentMethodFee > pricingFees > pricing > merchantDetail > commission |
Número | Valor total da comissão (com impostos) cobrada do lojista. |
paymentMethodFee > pricingFees > pricing > merchantDetail > interests |
Número | Valor total dos juros (com impostos) cobrados do lojista. |
paymentMethodFee > pricingFees > pricing > merchantDetail > total |
Número | Custo total para o lojista, incluindo juros e taxas. |
paymentMethodFee > pricingFees > pricing > totalValue |
Número | Valor total da transação, incluindo juros e taxas. |
paymentMethodFee > pricingFees > pricing > totalIncomeTransaction |
Número | Receita total gerada pela transação. |
paymentMethodFee > pricingFees > pricing > additionalInfo |
Objeto | Inclui informações financeiras como a Taxa Efetiva Anual (TEA) e o Custo Financeiro Total (CFT). Aplica-se apenas à Argentina. |
paymentMethodFee > pricingFees > pricing > additionalInfo > cft |
Número | Custo Financeiro Total (CFT) aplicado à transação. |
paymentMethodFee > pricingFees > pricing > additionalInfo > tea |
Número | Taxa Efetiva Anual (TEA) aplicada à transação. |
paymentMethodFee > pricingFees > promos |
Array | Lista de promoções disponíveis aplicáveis à configuração de preços. |
paymentMethodFee > pricingFees > promos > id |
Inteiro | ID único da promoção no sistema PayU. |
paymentMethodFee > pricingFees > promos > pricing |
Objeto | Contém os detalhes de precificação da promoção. |
paymentMethodFee > pricingFees > promos > pricing > payerDetail |
Objeto | Detalhamento dos juros e taxas para o pagador na promoção. |
paymentMethodFee > pricingFees > promos > pricing > payerDetail > commission |
Número | Comissão cobrada do pagador na promoção. |
paymentMethodFee > pricingFees > promos > pricing > payerDetail > interests |
Número | Juros cobrados do pagador na promoção. |
paymentMethodFee > pricingFees > promos > pricing > payerDetail > total |
Número | Valor total a ser pago pelo pagador, incluindo comissão e juros, na promoção. |
paymentMethodFee > pricingFees > promos > pricing > merchantDetail |
Objeto | Detalhamento dos juros e taxas para o lojista na promoção. |
paymentMethodFee > pricingFees > promos > pricing > merchantDetail > commission |
Número | Comissão cobrada do lojista na promoção. |
paymentMethodFee > pricingFees > promos > pricing > merchantDetail > interests |
Número | Juros cobrados do lojista na promoção. |
paymentMethodFee > pricingFees > promos > pricing > merchantDetail > total |
Número | Custo total para o lojista, incluindo comissão e juros, na promoção. |
paymentMethodFee > pricingFees > promos > pricing > totalValue |
Número | Valor total da transação com comissão e juros na promoção. |
paymentMethodFee > pricingFees > promos > pricing > totalIncomeTransaction |
Número | Receita total gerada pela transação na promoção. |
paymentMethodFee > pricingFees > promos > priority |
Número | Nível de prioridade da promoção na configuração de preços. |
promotions |
Objeto | Contém os detalhes da promoção aplicada (se houver). |
promotions > id |
Inteiro | ID único da promoção no sistema PayU. |
promotions > title |
String | Título da promoção (máx. 50 caracteres). |
promotions > termsAndConditions |
String | Termos e condições aplicáveis à promoção (máx. 250 caracteres). |
promotions > paymentMethod |
String | Meio de pagamento associado à promoção. |
promotions > subFranchise |
String | Sub-bandeira ou sub-franquia associada à promoção. |
promotions > banksNames |
Lista | Lista de bancos onde a promoção é válida. |
promotions > paymentMethodMain |
String | Meio de pagamento principal associado à promoção. |
promotions > iin |
Lista | Lista de números de cartão IIN/BIN elegíveis para a promoção. |
promotions > days |
Lista | Dias da semana em que a promoção está disponível. |
promotions > startDate |
DateTime | Data e hora de início da promoção. |
promotions > endDate |
DateTime | Data e hora de término da promoção. |
promotions > priority |
Número | Nível de prioridade da promoção. |
promotions > type |
String | Tipo de promoção. Valores possíveis: PRICING – A promoção é aplicada automaticamente com base nas regras de precificação configuradas. Por exemplo, no México, se as parcelas sem juros estiverem configuradas, o lojista precisa apenas enviar o número de parcelas em transaction > extraParameters > INSTALLMENTS_NUMBER. O sistema aplicará automaticamente a condição de parcelas sem juros, sem exigir um ID de promoção.MSI – Requer que o lojista envie explicitamente o ID da promoção e o número de parcelas. Isso se aplica quando a promoção deve corresponder a uma combinação específica de meio de pagamento, parcelas e ID de promoção. Para aplicar esse tipo, os seguintes campos devem ser enviados: - transaction > extraParameters > INSTALLMENTS_NUMBER- transaction > extraParameters > PROMOTION_IDNota: Se o ID da promoção não for enviado quando exigido, a transação será processada sem a promoção, utilizando a configuração padrão de preços para a opção de parcelamento selecionada. |
paymentTaxesDetails |
Objeto | Contém os detalhes dos impostos aplicados (estrutura depende da resposta do serviço de impostos). |
taxesServiceFailed |
Booleano | Indica se houve falha no serviço de cálculo de impostos. |
Chamada da API
Para recuperar as promoções disponíveis, envie uma solicitação GET utilizando o seguinte 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
A variável {env-api} deve ser definida da seguinte forma:
sandbox.apipara testesapipara produção
O parâmetro paymentMethod é opcional e pode ser usado para filtrar promoções por um meio de pagamento específico. Os parâmetros tax e taxReturnBase também são opcionais, mas se aplicam apenas na Argentina e na Colômbia.
Exemplo de requisição para a 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
Exemplo de requisição para a Colômbia:
https://sandbox.api.payulatam.com/payments-api/rest/v4.9/pricing?accountId=512321¤cy=COP&amount=11601.71&tax=1769.75&taxReturnBase=9831.96
Exemplo de requisição para o México:
https://sandbox.api.payulatam.com/payments-api/rest/v4.9/pricing?accountId=512324¤cy=MXN&amount=15662.37
Exemplo de requisição para o Peru:
https://sandbox.api.payulatam.com/payments-api/rest/v4.9/pricing?accountId=516634¤cy=PEN&amount=2897.78
Exemplo de resposta:
{
"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
}
<consultPriceListaResponse 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>
</consultPriceListaResponse>
Executando uma Transação com Parcelamento sem Juros
Depois de selecionar um plano de Parcelamento sem Juros, inclua PROMOTION_ID e INSTALLMENTS_NUMBER como parâmetros extras na sua requisição:
"extraParameters": {
"INSTALLMENTS_NUMBER": (número de parcelas),
"PROMOTION_ID": (ID da promoção selecionada)
}
<extraParameters>
<entry>
<string>INSTALLMENTS_NUMBER</string>
<string>Número de parcelas</string>
</entry>
<entry>
<string>PROMOTION_ID</string>
<string>ID da promoção selecionada</string>
</entry>
</extraParameters>
Nota
Para mais detalhes sobre a inclusão desses parâmetros extras, consulte a documentação correspondente da API de Pagamentos para o seu país:
Meses sem Juros (MSI - Meses Sin Intereses)
No México, as Parcelas Sem Juros Gerais são comumente conhecidas como Meses sem Juros (MSI). Essa opção permite oferecer planos de pagamento fixos (3, 6, 9, 12 ou 18 meses) sem juros, sem a necessidade de referenciar um ID de promoção.
Considerações
- Opções de parcelamento disponíveis: 3, 6, 9, 12 ou 18 meses.
- Valores mínimos de compra exigidos para MSI:
- 3 meses → $300 MXN
- 6 meses → $600 MXN
- 9 meses → $900 MXN
- 12 meses → $1200 MXN
- 18 meses → $1800 MXN
- O MSI está disponível nos seguintes bancos: BANAMEX, BANCO REGIONAL DE MONTERREY S.A, BANCOPPEL, BANCO AZTECA, SCOTIABANK, HSBC, INBURSA, BANCA MIFEL SA, BANCO MULTIVA, BAJIO, CI BANCO, Afirme, Banregio, Banjercito, Banorte, Famsa, Invex, Premium Card Liverpool, Santander e Bancomer.
- Ao utilizar a promoção, exiba sempre a frase MESES SIN INTERESES durante o processo de pagamento. Para parcelamentos padrão (sem promoção), utilize PAGOS DIFERIDOS.
Nota
Para habilitar os planos MSI na sua conta, entre em contato com seu representante de vendas.Parâmetros da requisição para MSI
Para aplicar MSI, inclua o número de meses no campo extraParameters:
"extraParameters": {
"INSTALLMENTS_NUMBER": (número de meses)
}
<extraParameters>
<entry>
<string>INSTALLMENTS_NUMBER</string>
<string>Número de meses</string>
</entry>
</extraParameters>
Para mais detalhes sobre o uso de MSI, consulte a API de Pagamentos para o México.
Última modificação
1 de agosto de 2025:
Documentation updates (6f985fff9)