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:
Campo | Ocorrência | Tipo | Tamanho | Descrição |
---|---|---|---|---|
Header <Hdr> | [1..1] | Container | Cabeçalho da mensagem. | |
MessageFunction <MsgFctn> | [1..1] | CodeSet | n 4 | Identifica o tipo de processo em que a mensagem se propõe. CMPV = Completion Advice ou RVRA = ReversalAdvice. |
ProtocolVersion <PrtcolVrsn> | [1..1] | Text | ans ...6 | Versão do protocolo utilizado na mensagem. |
CompletionAdvice <CmpltnAdvc> | [1..1] | Container | Informações relacionadas ao processo de captura ou desfazimento de uma autorização. | |
Environment <Envt> | [1..1] | Container | Ambiente da transação. | |
Merchant <Mrchnt> | [1..1] | Container | Dados do estabelecimento. | |
Identification <Id> | [1..1] | Text | an 32 | Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como SAK. |
TransactionIdentification <TxId> | [1..1] | Container | Dados de identificação da transação atribuída pelo POI. | |
TransactionDateTime <TxDtTm> | [1..1] | DateTime | ans 19 | Data 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] | Text | an ...32 | Identificação da transação atribuída pelo POI. Este campo será ecoado pelo adquirente. |
OriginalTransaction <OrgnlTx> | [1..1] | Container | Identificação da transação original | |
RecipientTransactionIdentification <RcptTxId> | [1..1] | Text | an ...35 | Identificação da transação definida pelo adquirente. |
TransactionDetails <TxDtls> | [1..1] | Container | Detalhes da transação. | |
Currency <Ccy> | [1..1] | CodeSet | n 3 | Moeda utilizada na transação em conformidade com a ISO 4217. |
TotalAmount <TtlAmt> | [1..1] | Amount | n ...23 | Valor 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:
Campo | Ocorrência | Tipo | Tamanho | Descrição |
---|---|---|---|---|
Header <Hdr> | [1..1] | Container | Cabeçalho da mensagem. | |
MessageFunction <MsgFctn> | [1..1] | CodeSet | n 4 | Identifica o tipo de processo em que a mensagem se propõe. “CMPK” = CompletionAdviceResponse ou “RVRR” = ReversalAdviceResponse. |
CreationDateTime <CreDtTm> | [0..1] | Text | ans 19 | Data de criação da mensagem |
ProtocolVersion <PrtcolVrsn> | [1..1] | Text | ans ...6 | Versão do protocolo utilizado na mensagem. |
CompletionAdviceResponse <CmpltnAdvcRspn> | [1..1] | Container | Informações sobre a resposta da captura ou desfazimento de uma autorização. | |
Environment <Envt> | [1..1] | Container | Ambiente da transação. | |
Merchant Identification <MrchntId> | [1..1] | Container | Dados do estabelecimento. | |
Identification <Id> | [1..1] | Text | an 32 | Identificação do estabelecimento comercial no adquirente. Também conhecido como SAK. |
POIId <POIId> | [0..1] | Container | Dados do ponto de interação. | |
Transaction <Tx> | [1..1] | Container | Dados da transação. | |
TransactionIdentification <TxId> | [1..1] | Container | Dados da identificação da transação definida pelo POI. | |
TransactionDateTime <TxDtTm> | [1..1] | DateTime | ans 19 | Data e hora da transação |
TransactionReference <TxRef> | [1..1] | Text | an ...32 | Identificação da transação definida pelo ponto de interação. Este campo será ecoado pelo adquirente. |
Response <Rspn> | [1..1] | CodeSet | n 4 | Resultado da transação. DECL = Declined, APPR = Approved, PART = Partial Approved, TECH = Technical Error. |