Mudanças no envio das tags de Retentativas

Introdução

Estamos atualizando o envio das tags que indicam os limites de retentativas nas respostas de transações para um novo formato.

O que mudou?

Agora enviaremos os limites de retentativa em um modelo de regras, ou seja, caso a transação haja mais de uma regra para retentativas, todas as suas informações serão demonstradas (atualmente a única bandeira com mais de uma regra é a MasterCard).

Com isso, adicionaremos o container <RtryRules>, esse container será enviado no container AuthstnRslt e conterá todas as regras de retentativa para tal transação. As tags já existentes; <RtryTxLmt> e <RtryTxDtLmt>, serão enviadas dentro de um novo container chamado <Rule>.

Com isso temos as seguintes tags e definições:

TagTipoDefinição
<RtryRules>ContainerContainer que contém todas as regras de retentativa para a transação.
<Rule>ContainerRegra de retentativa definida de acordo com as regras da bandeira.
<RtryTxLmt>an ...2Limite de retentativas de acordo com a data.
<RtryTxDtLmt>ans 19Data definida para o limite de retentativas.

Exemplos

<RtryRules>
	<Rule>
		<RtryTxLmt>7</RtryTxLmt>
		<RtryTxDtLmt>2023-04-01T19:04:59+00:00</RtryTxDtLmt>
	</Rule>
	<Rule>
		<RtryTxLmt>35</RtryTxLmt>
		<RtryTxDtLmt>2023-05-01T19:04:59+00:00</RtryTxDtLmt>
	</Rule>
</RtryRules>
<RtryTxLmt>35</RtryTxLmt>
<RtryTxDtLmt>2023-05-01T19:04:59+00:00</RtryTxDtLmt>
<RtryRules>
	<Rule>
		<RtryTxLmt>30</RtryTxLmt>
		<RtryTxDtLmt>2023-10-06T19:04:59+00:00</RtryTxDtLmt>
	</Rule>
</RtryRules>
<RtryTxLmt>30</RtryTxLmt> 
<RtryTxDtLmt>2023-10-06T19:04:59+00:00</RtryTxDtLmt>

Nos exemplos acima, temos uma demonstração de como o envio dessas regras de retentativas funcionaria na prática.

No exemplo da MasterCard temos:

  • Uma regra de retentativa indicando que a transação tem até 7 retentativas em um período de 24h.
  • E uma outra regra indicando que a transação tem até 35 tentativas em 30 dias.

Fase de Transição

Durante essa fase de transição entre o formato antigo e o novo, iremos enviar as regras no formato atual (apenas com as tags <RtryTxLmt> e <RtryTxDtLmt>) e no formato novo , assim existirá tempo suficiente para qualquer atualização necessária.

Ou seja, ficaria assim:

<TxRspn>
    <AuthstnRslt>
       <RtryRules>
         <Rule>
            <RtryTxLmt>7</RtryTxLmt>
            <RtryTxDtLmt>2022-09-06T19:04:59+00:00</RtryTxDtLmt>
         </Rule>
         <Rule>
            <RtryTxLmt>35</RtryTxLmt>
            <RtryTxDtLmt>2022-10-05T19:04:59+00:00</RtryTxDtLmt>
         </Rule>
       </RtryRules>
       <RtryTxLmt>7</RtryTxLmt> 
       <RtryTxDtLmt>2022-09-06T19:04:59+00:00</RtryTxDtLmt>
       <RspnToAuthstn>
          <Rspn>DECL</Rspn>
          <RspnRsn>9109</RspnRsn>
      </RspnToAuthstn>
    </AuthstnRslt>
</TxRspn>