Autorização de Subadquirentes com dados de sublojistas

Introdução

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 (Sponsored Merchant - Contém os dados de sublojista/sub-merchant) dentro de (SalesContext - Traz contexto para a venda).

Neste Container (SpnsrdMrchnt) temos as seguintes tags:

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

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

  • <ShrtNm> - Nome do sub-merchant (nome que irá fatura do portador, junto ao identificador da subadquirente já cadastrado na Stone, que não precisa ser enviado na requisição).
  • <MrchntCtgyCd> - MCC (merchant category code) do sub-merchant (corresponde ao tipo de atividade do CNAE do sub-merchant).

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>
               	    </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>