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

Autorização de Subadquirentes com dados de sublojistas

Introdução


❗️

Nova tag!

A partir do dia 11/04/2025 será obrigatório o envio da tag LegalName com a Razão Social dos sublojistas, em autorizações facilitadas por subcredenciadoras.

Essa exigência atende a uma determinação regulatória do Banco Central do Brasil (Bacen) para transações domésticas, garantindo maior conformidade no ecossistema de pagamentos.

<AccptrAuthstnReq>
  <AuthstnReq>
    <Cntxt>
      <SaleCntxt>
        <SpnsrdMrchnt>
          <LglNm>Razão Social</LglNm>
        </SpnsrdMrchnt>
      </SaleCntxt>
    </Cntxt>
  </AuthstnReq>
</AccptrAuthstnReq>

Conforme a regra das bandeiras, as transações de subadquirentes devem conter dados do lojista que realizou a transação. Para isso, utiliza-se o container <SpnsrdMrchnt> (Sponsored Merchant - contém os dados de sublojista/submerchant) dentro de <SaleCntxt> (SalesContext - traz contexto para a venda).

Neste container (SpnsrdMrchnt) temos as seguintes tags:

  • <City> - Indica a cidade do submerchant.
  • <CtrySubDvsn> - Sigla do estado onde o submerchant está localizado.
  • <PstlAdr> - CEP do submerchant.
  • <TaxIdTp> - Indicador de pessoa física ou jurídica (PRSN ou JRDC).
  • <TaxIdNb> - CNPJ/CPF do submerchant (apenas números).
  • <RegdIdr> - Identificador do submerchant na subadquirente.
  • <StrtNm> - Rua onde o submerchant está localizado.
  • <CtryCd> - Código do país do submerchant em conformidade com a ISO 3166. O valor deverá ser fixo: 076 (Brasil).
  • <Email> - Email do submerchant.
  • <URLAdr> - Endereço e-commerce do submerchant.
  • <Phne> - Telefone do submerchant.
  • <LglNm> - Razão Social do submerchant

Além dos dados recebidos nesse container, há duas tags que precisam ser populadas com dados do sublojista, são elas:

  • <ShrtNm> - Nome do submerchant¹ (nome que irá aparecer na fatura do portador, junto à sigla² que identifica a subadquirente).
  • <MrchntCtgyCd> - MCC (merchant category code) do submerchant³ (corresponde ao tipo de atividade do CNAE do submerchant).

¹ Para transações da bandeira Mastercard, será necessário identificar na tagShrtNm, da autorização, se o estabelecimento comercial faz parte do segmento de casas de câmbio. Exemplo: nomedomerchant*cambio.

² Caso a sigla já esteja cadastrada na Stone, não precisará ser enviada na tag ShrtNm. Caso contrário, o envio será obrigatório, seguindo o modelo [SIGLA]*[Nome do sublojista].


❗️

³ MCC de sublojista CPF

A partir de 1º de março de 2025, sublojistas cadastrados com CPF devem usar os MCCs autorizados pela Stone, em conformidade com as bandeiras. Revise e ajuste os sistemas para evitar multas. A padronização assegura conformidade regulatória, transparência e uma avaliação de risco eficaz.

MCCs possíveis:

5970Artesanatos / Materiais artísticos
8099Clínicas / Serviços médicos / Profissionais de saúde
8021Dentistas
7379Manutenção e reparo de computadores
1799Materiais e Serviços de Construção
8011Médicos
7538Oficinas / Garagens / Estacionamentos
742Petshop / Veterinário
7230Salão de Beleza / Cabeleireiro / Manicure
7349Serviços de limpeza / Manutenção
4121Táxi / Motorista de Aplicativos
5499Venda de Alimentos Variados / Bebidas / Restaurantes
5963Venda de Outros Produtos
5699Venda de Vestuário / Calçados / Moda

Request

Abaixo está um exemplo de uma transação com dados de sublojista e suas respostas.

<Document xmlns="urn:AcceptorAuthorisationRequestV02.1">
    <AccptrAuthstnReq>
        <Hdr>
            <MsgFctn>AUTQ</MsgFctn>
            <PrtcolVrsn>2.0</PrtcolVrsn>
        </Hdr>
        <AuthstnReq>
            <Envt>
                <Mrchnt>
                    <Id>                     
                        <Id>ABCDE123456789ABCDE123456789ABCD</Id>
                        <ShrtNm>LOJA DA MARIA</ShrtNm>
                    </Id>
                </Mrchnt>
                <POI>
                    <Id>
                        <Id>2FB4C89A</Id>
                    </Id>
                    <SysNm>Nome do Gateway</SysNm>
                </POI>
                <Card>
                    <PlainCardData>
                        <PAN>4000000000000010</PAN>
                        <XpryDt>2027-10</XpryDt>
                        <CardSctyCd>
                            <CSCVal>123</CSCVal>
                        </CardSctyCd>
                    </PlainCardData>
                </Card>
                <Crdhldr>
                    <Nm>Bruce Banner</Nm>
                </Crdhldr>
            </Envt>
            <Cntxt>
                <PmtCntxt>
                    <CardDataNtryMd>PHYS</CardDataNtryMd>
                    <TxChanl>ECOM</TxChanl>
                </PmtCntxt>
                <SaleCntxt>
                    <SpnsrdMrchnt>
                        <City>São Paulo</City>
                        <CtrySubDvsn>SP</CtrySubDvsn>
                        <PstlAdr>04110012</PstlAdr>
                        <TaxIdTp>JRDC</TaxIdTp>
                        <TaxIdNb>123456789000012</TaxIdNb>
                        <RegdIdr>175428814</RegdIdr>
                        <StrtNm>RUA DAS LOJAS</StrtNm>                 
                        <CtryCd>076</CtryCd>
                        <Email>[email protected]</Email>
                        <URLAdr>WWW.LOJADAMARIA.COM.BR</URLAdr>
                        <Phne>00987654321</Phne>
                        <LglNm>Loja da Maria ME</LglNm>
                    </SpnsrdMrchnt>
                </SaleCntxt>
            </Cntxt>
            <Tx>
                <InitrTxId>123123123</InitrTxId>
                <MrchntCtgyCd>8999</MrchntCtgyCd>
                <TxCaptr>true</TxCaptr>
                <TxId>
                    <TxDtTm>2020-06-01T15:11:06</TxDtTm>
                    <TxRef>ABCDEF-123456</TxRef>
                </TxId>
                <TxDtls>
                    <Ccy>986</Ccy>
                    <TtlAmt>100</TtlAmt>
                    <AcctTp>CRDT</AcctTp>
                    <RcrngTx>
                        <InstlmtTp>NONE</InstlmtTp>
                        <TtlNbOfPmts>0</TtlNbOfPmts>
                    </RcrngTx>
                </TxDtls>
            </Tx>
        </AuthstnReq>
    </AccptrAuthstnReq>
</Document>


<Document xmlns="urn:AcceptorAuthorisationResponseV02.1">
    <AccptrAuthstnRspn>
        <Hdr>
            <MsgFctn>AUTP</MsgFctn>
            <PrtcolVrsn>2.0</PrtcolVrsn>
            <CreDtTm>2020-06-01T15:11:09</CreDtTm>
        </Hdr>
        <AuthstnRspn>
            <Envt>
                <Card>
                    <CardBrnd>Visa</CardBrnd>
                </Card>
                <MrchntId>
                    <Id>ABCDE123456789ABCDE123456789ABCD</Id>
                    <ShrtNm>LOJA DA MARIA</ShrtNm>
                </MrchntId>
            </Envt>
            <Tx>
                <TxId>
                    <TxDtTm>2020-06-01T15:11:09</TxDtTm>
                    <TxRef>ABCDEF-123456</TxRef>
                </TxId>
                <RcptTxId>26770052347033</RcptTxId>
                <RcptOprId>2470000054384716</RcptOprId>
                <TxDtls>
                    <Ccy>986</Ccy>
                    <TtlAmt>100</TtlAmt>
                    <AcctTp>CRDT</AcctTp>
                </TxDtls>
            </Tx>
            <TxRspn>
                <AuthstnRslt>
                    <RspnToAuthstn>
                        <Rspn>APPR</Rspn>
                        <RspnRsn>0000</RspnRsn>
                    </RspnToAuthstn>
                    <AuthstnCd>347033</AuthstnCd>
                    <CmpltnReqrd>true</CmpltnReqrd>
                </AuthstnRslt>
                <Actn>
                    <ActnTp>DISP</ActnTp>
                    <MsgToPres>
                        <MsgDstn>MDSP</MsgDstn>
                        <MsgCntt>Aprovado</MsgCntt>
                    </MsgToPres>
                </Actn>
            </TxRspn>
        </AuthstnRspn>
    </AccptrAuthstnRspn>
</Document>

<Document xmlns="urn:AcceptorAuthorisationResponseV02.1">
    <AccptrAuthstnRspn>
        <Hdr>
            <MsgFctn>AUTP</MsgFctn>
            <PrtcolVrsn>2.0</PrtcolVrsn>
            <CreDtTm>2020-05-25T21:00:56</CreDtTm>
        </Hdr>
        <AuthstnRspn>
            <Envt>
                <Card>
                    <CardBrnd>Visa</CardBrnd>
                </Card>
                <MrchntId>
                    <Id>ABCDE123456789ABCDE123456789ABCD</Id>
                    <ShrtNm>LOJA DA MARIA</ShrtNm>
                </MrchntId>
            </Envt>
            <Tx>
                <TxId>
                    <TxDtTm>2020-06-01T15:11:09</TxDtTm>
                    <TxRef>ABCDEF-123456</TxRef>
                </TxId>
                <RcptTxId>26770052347033</RcptTxId>
                <RcptOprId>2470000054384716</RcptOprId>
                <TxDtls>
                    <Ccy>986</Ccy>
                    <TtlAmt>100</TtlAmt>
                    <AcctTp>CRDT</AcctTp>
                </TxDtls>
            </Tx>
            <TxRspn>
                <AuthstnRslt>
                    <RspnToAuthstn>
                        <Rspn>DECL</Rspn>
                        <RspnRsn>1016</RspnRsn>
                    </RspnToAuthstn>
                    <AuthstnCd>384716</AuthstnCd>
                    <CmpltnReqrd>false</CmpltnReqrd>
                </AuthstnRslt>
                <Actn>
                    <ActnTp>DISP</ActnTp>
                    <MsgToPres>
                        <MsgDstn>MDSP</MsgDstn>
                        <MsgCntt>Saldo insuficiente</MsgCntt>
                    </MsgToPres>
                </Actn>
            </TxRspn>
        </AuthstnRspn>
    </AccptrAuthstnRspn>
</Document>