Mudanças no request para o uso de recorrência

Para a utilização de recorrência em transações, inicialmente é necessário enviar a tag <AddtlSvc> com o valor RECP (Recurring Payment), abaixo é possível verificar em que parte do request irá a tag.

Deve ser enviado, também, uma segunda tag (), também é possível veirifcar logo abaixo seu local no request, que determinará se a transação se trata da primeira transação da série de recorrência ou uma das demais transações.

Série de recorrência

A primeira transação deve receber o valor FREC (First Recurring) na tag <SvcAttr>. E o modo de entrada deve ser Ecommerce.

<AccptrAuthstnReq> 
  <AuthstnReq>
    <Cntxt>
      <PmtCntxt>
        <CardDataNtryMd>PHYS</CardDataNtryMd>
        <TxChanl>ECOM</TxChanl>
      </PmtCntxt>
    </Cntxt>
    <Tx>
      <AddtlSvc>RECP</AddtlSvc>
      <SvcAttr>FREC</SvcAttr>
    </Tx>
  </AuthstnReq>
</AccptrAuthstnReq>

Já as demais transações recebem o valor RREC (Following Recurring) na tag <SvcAttr>. E o modo de entrada é cartão armazenado.

<AccptrAuthstnReq> 
  <AuthstnReq>
    <Cntxt>
      <PmtCntxt>
        <CardDataNtryMd>CDFL</CardDataNtryMd>
        <TxChanl>ECOM</TxChanl>
      </PmtCntxt>
    </Cntxt>
    <Tx>
      <AddtlSvc>RECP</AddtlSvc>
      <SvcAttr>RREC</SvcAttr>
    </Tx>
  </AuthstnReq>
</AccptrAuthstnReq>

🚧

CVV

Em transações recorrentes, o CVV só deve ser enviado na primeira transação da recorrência.

Identificador de recorrência

Ao iniciar uma série de recorrência, a bandeira gera um identifcador daquela transação (esse identificador é gerado em todas as transações) que deve ser enviado nas demais transações da série, isto é, ao receber o identificador, o integrador deve guardá-lo e enviar nos request das transações subsequentes daquela série de recorrência. Caso a série sofra alteração (como o valor da recorrência, por exemplo) uma nova série irá se iniciar (FREC) e um novo identificador deverá ser armanezado do lado do integrador para ser enviado nas demais transações dessa série.
Seguem abaixo as exemplficações de onde o identificador é enviado para o integrador no response da primeira transação da série e onde ele deve ser enviado no request para a Stone nas demais transações da série.

<Document xmlns="urn:AcceptorAuthorisationResponseV02.1">
	<AccptrAuthstnRspn>
		<AuthstnRspn>
			<Tx>
				<IssrTxId>IdentificadordaRecorrencia</IssrTxId>
			</Tx>
		</AuthstnRspn>
	</AccptrAuthstnRspn>
</Document>

<Document xmlns="urn:AcceptorAuthorisationRequestV02.1">
	<AccptrAuthstnReq>
		<AuthstnReq>
			<Tx>
				<OrgnlTx>
					<IssrTxId>IdentificadordaRecorrencia</IssrTxId>
				</<OrgnlTx>
			</Tx>
		</AuthstnReq>
	</AccptrAuthstnReq>
</Document>

❗️

Para a Bandeira Elo e a bandeira Visa o envio do identificador é obrigatório

📘

Para Bandeira Elo o identificador da série permanece o mesmo ainda que mude de adquirente as autorizações