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