API de Promoções
A API de Promoções permite recuperar as promoções disponíveis, incluindo seus custos associados, características e outros detalhes relevantes para seus clientes.
A API de Promoções está disponível nos seguintes países:
| País | Promoções | Meses Sem Juros (MSI) |
|---|---|---|
 Argentina |
✓ | ✓ |
 Colômbia |
✓ | ❌ |
 México |
✓ | ✓ |
 Peru |
✓ | ❌ |
Observação
Para configurar Parcelamentos e Promoções com base nos seus acordos com as entidades bancárias, entre em contato com seu representante de vendas.Promoções
O recurso de Promoções permite consultar promoções ativas via API, recuperar seus detalhes e apresentá-los aos clientes.
Uma promoção inclui os métodos de pagamento aplicáveis, os dias da semana elegíveis, uma lista de bancos participantes e as datas de início e término da validade.
Autenticação para Promoçõ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 a chave de acesso. Em seguida, concatene o resultado com MerchantPublicKey onforme 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
Consulte as Promoções 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 método de pagamento. | Não |
Parâmetros de Resposta
| Nome do Campo | Tipo | Tamanho | Descrição |
|---|---|---|---|
| promotion > id | Inteiro | Identificador único da promoção na plataforma PayU. | |
| promotion > title | String | 50 | Título da promoção. |
| promotion > termsAndConditions | String | 250 | Termos e condições aplicáveis à promoção. |
| promotion > paymentMethod | String | Nome do meio de pagamento disponível para a promoção. | |
| promotion > subFranchise | String | Nome da sub-bandeira/sub-franquia do meio de pagamento. | |
| promotion > banks | Lista | Lista de bancos onde a promoção se aplica. | |
| promotion > iins | Lista | Lista de números IIN/BIN bancários onde a promoção se aplica. | |
| promotion > days | Lista | Lista de dias em que a promoção é válida. | |
| promotion > startDate | Datetime | Data de início da promoção. | |
| promotion > endDate | Datetime | Data de término da promoção. | |
| paymentMethodFee | Lista | Descrição dos custos assumidos pelo lojista com base no meio de pagamento. | |
| paymentMethodFee > paymentMethodFeeDetail.paymentMethod | String | Nome do meio de pagamento. | |
| paymentMethodFeeDetail > pricingFees | Objeto | Contém detalhes de precificação para meios de pagamento e planos de parcelamento. | |
| paymentMethodFeeDetail > pricingFees > fee > installments | String | Parcela única (1) ou um intervalo de parcelas (1-36 para países aplicáveis). | |
| paymentMethodFeeDetail > pricingFees > fee > pricing | Objeto | Valores de precificação padrão para a transação. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > payerDetail | Objeto | Detalhamento dos juros e taxas aplicados ao pagador. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > payerDetail > commission | Decimal | Taxas totais, incluindo impostos aplicáveis, cobradas do pagador. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > payerDetail > interests | Decimal | Juros totais, incluindo impostos aplicáveis, cobrados do pagador. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > payerDetail > total | Decimal | Valor total que o pagador deve pagar, incluindo taxas e juros. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > merchantDetail | Objeto | Detalhamento dos juros e taxas aplicados ao lojista. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > merchantDetail > commission | Decimal | Taxas totais, incluindo impostos aplicáveis, cobradas do lojista. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > merchantDetail > interests | Decimal | Juros totais, incluindo impostos aplicáveis, cobrados do lojista. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > merchantDetail > total | Decimal | Valor total que o lojista deve pagar devido a taxas e juros. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > totalValue | Decimal | Valor total do pagamento, incluindo taxas e juros. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > totalIncomeTransaction | Decimal | Receita total gerada com a transação. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > additionalInfo | Objeto | Inclui informações sobre a Taxa Efetiva Anual (TEA) e o Custo Financeiro Total (CFT). Disponível para a Argentina. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > additionalInfo > cft | Decimal | Custo Financeiro Total (CFT) aplicado. | |
| paymentMethodFeeDetail > pricingFees > fee > pricing > additionalInfo > tea | Decimal | Taxa Efetiva Anual (TEA) aplicada. |
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}
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.
Exemplo de Requisição:
GET https://sandbox.api.payulatam.com/payments-api/rest/v4.9/pricing?accountId=512322¤cy=ARS&amount=1000
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 Promoções
Depois de selecionar uma promoção, 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)
Para contas no México, você pode oferecer aos clientes a opção de pagar em um número determinado de parcelas sem juros. Para ativar essa funcionalidade, entre em contato com seu representante de vendas.
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
- MSI está disponível com os 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 usar MSI, sempre exiba a frase “PAGOS DIFERIDOS” durante o processo de pagamento.
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
7 de fevereiro de 2025:
Documentation Updates (3ab7a7b0a)