API Reference
These docs are for v3.4. Click to read the latest docs for v4.0.

Tokenização com criptograma

Introdução

Alguns Token Providers utilizam criptogramas em cada transação com cartão tokenizado, como no caso do programa M4M (MDES for Merchants) da Mastercard.

Para esses casos, o request deve ser enviado da seguinte forma:

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> <!-- No contexto de tokenização, em <Card>, forneça os dados referentes ao Token -->
                    <PlainCardData>
                        <PAN>TOKEN</PAN> 
                        <XpryDt>2021-12</XpryDt> 
                        <CardSctyCd>
                            <CSCVal>CVV</CSCVal>
                        </CardSctyCd>
                    </PlainCardData>
                </Card> <!-- No contexto de tokenização, em <Card>, forneça os dados referentes ao Token -->
                <PmtTkn>
                    <TknRqstr>
                        <RqstrId>Token requestor Id</RqstrId> <!-- Opcional -->
                    </TknRqstr>
                    <TknAssrncData>Criptograma do token</TknAssrncData>
                    <!-- Tipo do criptograma - EmvTkn = Token gerado através do merchant, possuindo criptograma do token -->
                    <TknChrtc>EMVTKN</TknChrtc>
                </PmtTkn>
                <Wllt>
                    <!-- Provedor da carteira digital/token (no caso do M4M para Master) -->
                    <Prvdr>APPL</Prvdr>
                    <!--Apple Pay-->
                </Wllt>
            </Envt>
            <Cntxt>
                <PmtCntxt>
                    <TxEnvt>MERC</TxEnvt>
                    <TxChanl>ECOM</TxChanl>
                </PmtCntxt>
            </Cntxt>
            <Tx>
                <InitrTxId>TEST_Elo</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>

❗️

Criptograma do token

Para Visa e Elo, é fundamental garantir o envio do criptograma no formato Base 64.