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>