InApp

Introdução

Quando o usuário se interessa por um algum item à venda dentro de um aplicativo (Ex.: Uma loja ou um jogo), ele pode realizar a compra pelo recurso de “InApp Purchase”. Nessa forma de compra, o cartão do portador que foi tokenizado dentro de uma wallet (Ex.: ApplePay ou Google Pay) integrada com uma loja de apps (AppStore, PlayStore) é utilizado na modalidade crédito caso alguma compra seja feita dentro do aplicativo em questão.

A modalidade de compra InApp, na maioria da vezes exige um fator de autenticação (biometria, FaceID).
Esse fator de autenticação gera um criptograma de autenticação, que precisa ser enviado nessas transações.

Como Utilizar

Nestes casos, a transação deverá ser enviada com o valor INAP na tag <AuthntcnMtd> e o criptograma de autenticação deverá ser enviado <AuthntcnVal>.

Abaixo temos os possíveis valores a serem enviados na tag <AuthntcnRslt>

ValorDescrição
CRPTIndica que houve uma autenticação com sucesso e que o criptograma será enviado.
DENYIndica que a transação não foi autenticada.
AUTHIndica que houve uma tentativa de autenticação e o emissor não suporta o protocolo.
UCRPIndica que houve uma autenticação com sucesso e que o criptograma não será enviado.

Exemplo de Mensagem de Autenticação In-App:

<Authntcn>
        <AuthntcnMtd>INAP</AuthntcnMtd>
        <AuthntcnVal>12341234123412341234</AuthntcnVal>
        <AuthntcnRslt>CRPT</AuthntcnRslt>
</Authntcn>

Request

<?xml version="1.0" encoding="utf-8"?>
<Document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="urn:AcceptorAuthorisationRequestV02.1">
    <AccptrAuthstnReq>
        <Hdr>
            <MsgFctn>AUTQ</MsgFctn>
            <PrtcolVrsn>2.0</PrtcolVrsn>
        </Hdr>
        <AuthstnReq>
            <Envt>
                <Mrchnt>
                    <Id>
                        <Id>SAK</Id>
                        <Tp>OPOI</Tp>
                        <Issr>MERC</Issr>
                    </Id>
                </Mrchnt>
                <Card>
                    <PlainCardData>
                        <PAN>PAN</PAN>
                        <XpryDt>2024-10</XpryDt>
                    </PlainCardData>
                </Card>
                <Crdhldr>
                    <Authntcn>
                        <AuthntcnMtd>INAP</AuthntcnMtd>
                        <AuthntcnVal>AKC76Y/-------==</AuthntcnVal>
                    </Authntcn>
                </Crdhldr>
            </Envt>
            <Cntxt>
                <PmtCntxt>
                    <TxEnvt>MERC</TxEnvt>
                    <TxChanl>ECOM</TxChanl>
                </PmtCntxt>
            </Cntxt>
            <Tx>
                <InitrTxId>Teste</InitrTxId>
                <TxCaptr>true</TxCaptr>
                <TxId>
                    <TxDtTm>2020-02-05T15:11:06</TxDtTm>
                    <TxRef>-----------</TxRef>
                </TxId>
                <TxDtls>
                    <Ccy>986</Ccy>
                    <TtlAmt>4000</TtlAmt>
                    <AcctTp>CRDT</AcctTp>
                    <RcrngTx>
                        <InstlmtTp>NONE</InstlmtTp>
                        <TtlNbOfPmts>0</TtlNbOfPmts>
                    </RcrngTx>
                </TxDtls>
            </Tx>
        </AuthstnReq>
    </AccptrAuthstnReq>
</Document>