Limite de Retentativas

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>

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>

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.