Introdução
Com a intenção de colocar o empreendedor em primeiro lugar, identificamos que muitos dos nossos parceiros estavam sendo penalizados com cobranças devido ao envio de múltiplas retentativas de transações, com isso, percebemos a oportunidade de repassarmos informações adicionais através da resposta de nossa API para minimizar tais riscos.
Realizamos a inclusão de 2 tags relacionadas à retentativas no XML de resposta das operações, representando:
1. Limite de retentativas da bandeira
As tags de limite de retentativas e período máximo tem como principal objetivo auxiliar nas regras de retentativas, para que todos os clientes possam se enquadrar nas regras de cada bandeira.
2. Data máxima para a realização de retentativas
Encaminhamos a data limite para a realização das retentativas.
Limite de retentativas (RetryTransactionLimit) <RtryTxLmt>
<RtryTxLmt>
Nessa tag será retornado o limite de retentativas de acordo com o código de resposta da bandeira. Caso a transação não tenha um limite de retentativas, essa tag não será retornada.
Para códigos de resposta que não permitem retentativas, será retornado o valor “0”.
Exemplos
Exemplo de resposta de transação com limite de 10 retentativas:
<TxRspn>
<AuthstnRslt>
<RtryTxLmt>10</RtryTxLmt>
<RtryTxDtLmt>2021-05-12T23:59:59+00:00</RtryTxDtLmt>
<AuthstnRslt>
<TxRspn>
Exemplo de resposta de transação indicando que retentativas não são permitidas:
<TxRspn>
<AuthstnRslt>
<RtryTxLmt>0</RtryTxLmt>
<AuthstnRslt>
<TxRspn>
Exemplo de resposta de transação sem limite de retentativas:
<TxRspn>
<AuthstnRslt>
...
</AuthstnRslt>
</TxRspn>
Data limite de retentativas (RetryTransactionDateLimit) <RtryTxDtLmt>
<RtryTxDtLmt>
Nessa tag será retornada a data e hora limite para o envio da quantidade de retentativas permitidas, ou seja, até quando será possível retentar X vezes. Em transações sem limite de retentativas ou que não permitem retentativas, a tag não será retornada.
A data será retornada no formato DateTimeOffset, com o offset UTC -3.
Exemplos
Exemplo onde seria possível retentar 10 vezes a mesma transação até o final do dia da transação*
(supondo que a primeira transação ocorreu no dia 12/05/2021):
<TxRspn>
<AuthstnRslt>
<RtryTxLmt>10</RtryTxLmt>
<RtryTxDtLmt>2021-05-12T23:59:59+00:00</RtryTxDtLmt>
<AuthstnRslt>
<TxRspn>
Exemplo onde seria possível retentar 15 vezes a mesma transação até o final do mês
(supondo que a primeira transação ocorreu no dia 12/05/2021):
<TxRspn>
<AuthstnRslt>
<RtryTxLmt>15</RtryTxLmt>
<RtryTxDtLmt>2021-05-30T23:59:59+00:00</RtryTxDtLmt>
<AuthstnRslt>
<TxRspn>
Não é possível retentar essa mesma transação:
<TxRspn>
<AuthstnRslt>
<RtryTxLmt>0</RtryTxLmt>
<AuthstnRslt>
<TxRspn>
Ponto de Atenção
No dia seguinte após a data limite, essa contagem se inicia novamente, ou seja, é possível retentar mais 10 vezes até o final do dia para o primeiro exemplo ou, 15 vezes para o mês seguinte no segundo exemplo.