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:
Tag | Tipo | Definição |
---|---|---|
<RtryRules> | Container | Container que contém todas as regras de retentativa para a transação. |
<Rule> | Container | Regra de retentativa definida de acordo com as regras da bandeira. |
<RtryTxLmt> | an ...2 | Limite de retentativas de acordo com a data. |
<RtryTxDtLmt> | ans 19 | Data 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>