CompletionAdvice (Captura)

Introdução

Neste item exemplificamos o modelo esperado pela nossa API para as requisições de captura posterior e o mapeamento das tags da mensagem de resposta.

Deve-se adicionar o endpoint /CompletionAdvice ao endereço de conexão.

👍

Exemplo.:

https://sandbox-auth-integration.stone.com.br/CompletionAdvice

Novas mudanças

Bloqueio de operações de captura por ITK

Todas as operações de captura deverão ser realizadas utilizando ATK ao invés de ITK.

Tags da Mensagem de Requisição

Abaixo estão descritas as tags para a mensagem de requisição de captura posterior:

CampoOcorrênciaTipoTamanhoDescrição
Header <Hdr>[1..1]ContainerCabeçalho da mensagem.
MessageFunction <MsgFctn>[1..1]CodeSetn 4Identifica o tipo de processo em que a mensagem se propõe. CMPV = Completion Advice ou RVRA = ReversalAdvice.
ProtocolVersion <PrtcolVrsn>[1..1]Textans ...6Versão do protocolo utilizado na mensagem.
CompletionAdvice <CmpltnAdvc>[1..1]ContainerInformações relacionadas ao processo de captura ou desfazimento de uma autorização.
Environment <Envt>[1..1]ContainerAmbiente da transação.
Merchant <Mrchnt>[1..1]ContainerDados do estabelecimento.
Identification <Id>[1..1]Textan 32Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como SAK.
TransactionIdentification <TxId>[1..1]ContainerDados de identificação da transação atribuída pelo POI.
TransactionDateTime <TxDtTm>[1..1]DateTimeans 19Data local e hora da transação atribuído pelo POI, no formato:
yyyy-mm-ddTHH:mm:SS. Este campo será ecoado pelo adquirente.
TransactionReference <TxRef>[1..1]Textan ...32Identificação da transação atribuída pelo POI. Este campo será ecoado pelo adquirente.
OriginalTransaction <OrgnlTx>[1..1]ContainerIdentificação da transação original
RecipientTransactionIdentification <RcptTxId>[1..1]Textan ...35Identificação da transação definida pelo adquirente.
TransactionDetails <TxDtls>[1..1]ContainerDetalhes da transação.
Currency <Ccy>[1..1]CodeSetn 3Moeda utilizada na transação em conformidade com a ISO 4217.
TotalAmount <TtlAmt>[1..1]Amountn ...23Valor total da transação em centavos.

Pedido de Captura Posterior

<Document xmlns="urn:AcceptorCompletionAdviceV02.1">
    <AccptrCmpltnAdvc>
        <Hdr>
            <MsgFctn>CMPV</MsgFctn>
            <PrtcolVrsn>2.0</PrtcolVrsn>
        </Hdr>
        <CmpltnAdvc>
            <Envt>
                <Mrchnt>
                    <Id>
                        <Id>ABCDE123456789ABCDE123456789ABCD</Id>
                    </Id>
                </Mrchnt>
            </Envt>
            <Tx>
                <TxId>
                    <TxDtTm>2014-06-11T17:15:44</TxDtTm>
                    <TxRef>1111</TxRef>
                </TxId>
                <OrgnlTx>
                    <RcptTxId>9CDF257AQKR</RcptTxId>
                </OrgnlTx>
                <TxDtls>
                    <Ccy>986</Ccy>
                    <TtlAmt>100</TtlAmt>
                </TxDtls>
            </Tx>
        </CmpltnAdvc>
    </AccptrCmpltnAdvc>
</Document>

Tags da Mensagem de Resposta

Abaixo estão descritas as tags para a mensagem de resposta de captura posterior:

CampoOcorrênciaTipoTamanhoDescrição
Header <Hdr>[1..1]ContainerCabeçalho da mensagem.
MessageFunction <MsgFctn>[1..1]CodeSetn 4Identifica o tipo de processo em que a mensagem se propõe. “CMPK” = CompletionAdviceResponse ou “RVRR” = ReversalAdviceResponse.
CreationDateTime <CreDtTm>[0..1]Textans 19Data de criação da mensagem
ProtocolVersion <PrtcolVrsn>[1..1]Textans ...6Versão do protocolo utilizado na mensagem.
CompletionAdviceResponse <CmpltnAdvcRspn>[1..1]ContainerInformações sobre a resposta da captura ou desfazimento de uma autorização.
Environment <Envt>[1..1]ContainerAmbiente da transação.
Merchant Identification <MrchntId>[1..1]ContainerDados do estabelecimento.
Identification <Id>[1..1]Textan 32Identificação do estabelecimento comercial no adquirente. Também conhecido como SAK.
POIId <POIId>[0..1]ContainerDados do ponto de interação.
Transaction <Tx>[1..1]ContainerDados da transação.
TransactionIdentification <TxId>[1..1]ContainerDados da identificação da transação definida pelo POI.
TransactionDateTime <TxDtTm>[1..1]DateTimeans 19Data e hora da transação
TransactionReference <TxRef>[1..1]Textan ...32Identificação da transação definida pelo ponto de interação. Este campo será ecoado pelo adquirente.
Response <Rspn>[1..1]CodeSetn 4Resultado da transação. DECL = Declined, APPR = Approved, PART = Partial Approved, TECH = Technical Error.