Introdução

Neste item exemplificamos o modelo esperado pela nossa API para as requisições de autorização e o mapeamento das tags para a mensagem de resposta.

Deve-se adicionar o endpoint /Authorize ao endereço de conexão.

👍
Exemplo.:
https://sandbox-auth-integration.stone.com.br/Authorize

Tags da Mensagem de Requisição

Abaixo estão descritas as tags para a mensagem de requisição de autorização:

📘
Info
Para saber mais informações, passe o mouse sobre a tag.

Campo	Ocorrência	Tipo	Tamanho	Hierarquia
Acceptor Authorization Request `<AccptrAuthstnReq>`	[1..1]	Container	-	1
Header `<Hdr>`	[1..1]	Container	-	1.1
MessageFunction `<MsgFctn>`	[1..1]	CodeSet	ans ...6	1.1.1
ProtocolVersion `<PrtcolVrsn>`	[1..1]	Text	ans ...6	1.1.2
Initiating Party `<InitgPty>`	[0..1]	Container	-	1.1.3
Party Identification `<Id>`	[1..1]	Text	ans ... 35	1.1.3.1
Party ShortName `<ShrtNm>`	[0..1]	Text	ans ... 35	1.1.3.2
AuthorisationRequest `<AuthstnReq>`	[1..1]	Container	-	1.2
Environment `<Envt>`	[1..1]	Container	-	1.2.1
Merchant `<Mrchnt>`	[1..1]	Container	-	1.2.1.1
Merchant Identification `<ID>`	[1..1]	Container	-	1.2.1.1.1
SaleAffilitionKey Identification `<ID>`	[1..1]	Text	ans 32	1.2.1.1.1.1
Merchant ShortName `<ShrtNm>`	[0..1]	Text	ans ...35	1.2.1.1.1.2
Point of Interaction `<POI>`	[1..1]	Container	-	1.2.1.2
SystemName `<SysNm>`	[1..1]	Text	ans ...70	1.2.1.2.1
POI Identification `<ID>`	[1..1]	Container	-	1.2.1.2.2
POI Code Identification `<ID>`	[1..1]	Text	ans ...35	1.2.1.2.2.1
Card `<Card>`	[1..1]	Container	-	1.2.1.3
PlainCardData `<PlainCardData>`	[0..1]	Container	-	1.2.1.3.1
PAN `<PAN>`	[1..1]	Text	n ...19	1.2.1.3.2
ExpiryDate `<XpryDt>`	[1..1]	Text	ans 7	1.2.1.3.3
Card Security Code `<CardSctyCd>`	[1..1]	Container	-	1.2.1.3.4
CSC Value `<CSCVal>`	[0..1]	Text	n ...4	1.2.1.3.4.1
CardHolder `<Crdhldr>`	[1..1]	Container	-	1.2.1.4
Name `<Nm>`	[1..1]	Text	an ...45	1.2.1.4.1
Authentication `<Authntcn>`	[0..1]	Container	-	1.2.1.4.2
AuthenticationMethod `<AuthntcnMtd>`	[1..1]	Text	an 4	1.2.1.4.2.1
AuthenticationValue `<AuthntcnVal>`	[1..1]	Text	ans ...625	1.2.1.4.2.2
AuthenticationResult `<AuthntcnRslt>`	[1..1]	Text	an 4	1.2.1.4.2.3
3DSecure `<TdScre>`	[1..1]	Container	-	1.2.1.4.2.4
TransactionID `<TxId>`	[1..1]	Text	ans ...36	1.2.1.4.2.3.1
Versão 3DS `<TdScreVrsn>`	[1..1]	Text	an 4	1.2.1.4.2.4.2
Context `<Cntxt>`	[1..1]	Container	-	1.2.2
PaymentContext `<PmtCntxt>`	[1..1]	Container	-	1.2.2.1
CardDataEntryMode `<CardDataNtryMd>`	[1..1]	CodeSet	an 4	1.2.2.1.1
TransactionChannel `<TxChanl>`	[1..1]	CodeSet	an 4	1.2.2.1.2
SalesContext `<SaleCntxt>`	[0..1]	Container	-	1.2.2.2
SponsoredMerchant `<SpnsrdMrchnt>`	[1..1]	Container	-	1.2.2.2.1
City `<City>`	[1..1]	Text	ans …35	1.2.2.2.2
Street Name `<StrtNm>`	[1..1]	Text	ans …35	1.2.2.2.3
PostalAddress `<PstlAdr>`	[1..1]	Text	n …16	1.2.2.2.4
Country SubDivision (Estado do sub-merchant) `<CtrySubDvsn>`	[1..1]	Text	n ...2	1.2.2.2.5
Country Code `<CtryCd>`	[1..1]	Text	n 3	1.2.2.2.6
TaxIdentificationType `<TaxIdTp>`	[1..1]	Text	an …4	1.2.2.2.7
TaxIdentificationNumber `<TaxIdNb>`	[1..1]	Text	n …35	1.2.2.2.8
RegisteredIdentifier `<RegdIdr>`	[1..1]	Text	an ... 15	1.2.2.2.9
Transaction `<Tx>`	[1..1]	Container	-	1.2.3
AdditionalService `<AddtlSvc>`	[0..1]	CodeSet	an 4	1.2.3.1
ServiceAttribute `<SvcAttr>`	[0..1]	CodeSet	an 4	1.2.3.2
InitiatorTransactionIdentification `<InitrTxId>`	[1..1]	Text	an ...32	1.2.3.3
MerchantCategoryCode `<MrchntCtgyCd>`	[0..1]	Text	n 4	1.2.3.4
TransactionCapture `<TxCaptr>`	[1..1]	Boolean	an 4	1.2.3.5
TransactionType `<TxTp>`	[0..1]	Text	an 4	1.2.3.6
TransactionIdentification `<TxId>`	[1..1]	Container	-	1.2.3.7
TransactionDateTime `<TxDtTm>`	[1..1]	DateTime	ans 19	1.2.3.7.1
TransactionReference `<TxRef>`	[1..1]	Text	an ...32	1.2.3.7.2
TransactionDetails `<TxDtls>`	[1..1]	Container	-	1.2.3.8
Currency `<Ccy>`	[1..1]	CodeSet	n 3	1.2.3.8.1
TotalAmount `<TtlAmt>`	[1..1]	Amount	n ...23	1.2.3.8.2
AccountType `<AcctTp>`	[0..1]	Text	an 4	1.2.3.8.3
RecurringTransaction `<RcrngTx>`	[0..1]	Container	-	1.2.3.8.4
InstalmentType `<InstlmtTp>`	[1..1]	Text	an 4	1.2.3.8.4.1
TotalNumberOfPayments `<TtlNbOfPmts>`	[1..1]	Number	n ...2	1.2.3.8.4.2

Pedido de Autorização

<Document xmlns="urn:AcceptorAuthorisationRequestV02.1">
    <AccptrAuthstnReq>
        <Hdr>
            <MsgFctn>AUTQ</MsgFctn>
            <PrtcolVrsn>2.0</PrtcolVrsn>
        </Hdr>
        <AuthstnReq>
            <Envt>
                <Mrchnt>
                    <Id>
                        <Id>ABCDE123456789ABCDE123456789ABCD</Id>
                        <ShrtNm>Nome da fatura</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> 
                  <Authntcn>
                    <AuthntcnMtd>TDSC</AuthntcnMtd>
                    <AuthntcnVal>T420701032124328jJJLtQa+Iws8AREAEbjsA1MAAAA=</AuthntcnVal>
                    <AuthntcnRslt>CRPT</AuthntcnRslt>
                    <TdScre>
                      <TxId>f38e6948-5388-41a6-bca4-b49723c19437</TxId> 
                      <TdScreVrsn>VRS2<TdScreVrsn> 
                    </TdScre>
                  </Authntcn>
                </Crdhldr>
            </Envt>
            <Cntxt>
              <PmtCntxt>
                <CardDataNtryMd>PHYS</CardDataNtryMd>
                <TxChanl>ECOM</TxChanl>
              </PmtCntxt>
              <SaleCntxt>
                <SpnsrdMrchnt>
                  <City>São Paulo</City>
                  <PstlAdr>04119010</PstlAdr>
                  <TaxIdTp>JRDC</TaxIdTp>
                  <TaxIdNb>123456789000012</TaxIdNb>
                  <RegdIdr>175428814</RegdIdr>
                </SpnsrdMrchnt>
              </SaleCntxt>
            </Cntxt>
            <Tx>
                <AddtlSvc>RECP</AddtlSvc>
                <SvcAttr>FREC</SvcAttr>
                <InitrTxId>123123123</InitrTxId>
                <TxCaptr>false</TxCaptr>
                <TxId>
                    <TxDtTm>2023-00-00T00:00:00</TxDtTm>
                    <TxRef>06064f516a50483da7f189243c95ccca</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>

❗️
Crédito à vista
Transações de crédito à vista devem ser sempre enviadas com InstallmentType = "NONE" e TotalNumberOfPayments = "0".

Tags na Mensagem de Resposta

Abaixo estão descritas as tags para a mensagem de resposta de autorização:

Campo	Ocorrência	Tipo	Tamanho	Descrição
Header `<Hdr>`	[1..1]	Container		Cabeçalho da mensagem
MessageFunction `<MsgFctn>`	[1..1]	CodeSet	n 4	Identifica o tipo de processo em que a mensagem se propõe. Fixo: AUTP = AuthorisationResponse.
ProtocolVersion `<PrtcolVrsn>`	[1..1]	Text	ans ...6	Versão do protocolo utilizado na mensagem.
CreationDateTime `<CreDtTm>`	[1..1]	Text	ans 19	Data de criação da mensagem no formato: yyyy-mm-ddTHH:MM:SS
AuthorisationResponse `<AuthstnRspn>`	[1..1]	Container		Informações relacionadas à resposta da autorização.
Environment `<Envt>`	[1..1]	Container		Ambiente da transação.
Card `<Card>`	[1..1]	Container		Dados do cartão
CardBrand `<CardBrnd>`	[1..1]	Text	ans ...30	Nome da bandeira que foi realizada a transação
Merchant Identification `<MrchntId>`	[1..1]	Container		Dados do estabelecimento.
Identification `<Id>`	[1..1]	Text	an 32	Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.
POIId `<POIId>`	[0..1]	Container		Dados do ponto de interação.
Identification `<Id>`	[1..1]	Text	an 32	Identificação do POI.
Transaction `<Tx>`	[1..1]	Container		Informações da transação.
TransactionIdentification `<TxId>`	[1..1]	Container		Dados de identificação da transação atribuída pelo POI (Ponto de interação).
TransactionDateTime `<TxDtTm>`	[1..1]	DateTime	ans 19	Data local e hora da transação atribuído pelo POI (ponto de interação). Este campo será ecoado pelo adquirente.
TransactionReference `<TxRef>`	[1..1]	Text	an …32	Identificação da transação atribuída pelo POI (Ponto de interação). Este campo será ecoado pelo adquirente.
RecipientTransactionIdentification `<RcptTxId>`	[1..1]	Text	an ...35	Identificação da transação definida pela Stone. Este campo é conhecido internamente na Stone como ATK
RecipientOperationIdentification `<RcptOprId>`	[1..1]	Text	an ...35	Identificação da operação nos sistemas da Stone.
IssuerTransactionIdentification `<IssrTxId>`	[0..1]	Text	an ...35	Identificação da transação definida pela bandeira.
TransactionDetails `<TxDtls>`	[1..1]	Container		Detalhes da transação.
Currency `<Ccy>`	[1..1]	CodeSet	n 3	Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.
TotalAmount `<TtlAmt>`	[1..1]	Amount	n ...23	Valor total autorizado em centavos.
AccountFundingSource `<AcctFndSrc>`	[1..1]	Text	n ...7	Tipo de conta que será utilizada pelo emissor caso a transação seja aprovada.
AccountType `<AcctTp>`	[0..1]	CodeSet	an 4	Modalidade do cartão utilizado na transação. CRDT = Crédito;
TransactionResponse `<TxRspn>`	[1..1]	Container		Dados de resposta da transação.
AuthorisationResult `<AuthstnRslt>`	[1..1]	Container		Resultado da autorização.
ResponseToAuthorisation`<RspnToAuthstn>`	[1..1]	Container		Dados da resposta da autorização.
Response `<Rspn>`	[1..1]	CodeSet	an 4	Resposta da transação: DECL: Declined, APPR: Aproved, PART: PartialApproved, e TECH: TechinicalError.
ResponseReason `<RspnRsn>`	[1..1]	Text	n 4	Código de resposta da autorização (equivalente ao campo 39 da ISO 8583 de 2003).
SchemeResponse `<SchmRspn>`	[0..1]	Text	an …3	Código de resposta da bandeira.
AuthorisationCode `<AuthstnCd>`	[0..1]	Text	n 40	Código de autorização retornado pelo emissor.
CompletionRequired `<CmpltnReqrd>`	[0..1]	Boolean	an 4	Indica se a mensagem precisa ser capturada posteriormente.
Action `<Actn>`	[0..*]	Container		Mensagem a ser demonstrada no display
ActionType `<ActnTp>`	[1..1]	CodeSet	n 4	Fixo: DISP
MessageToPresent `<MsgToPres>`	[1..1]	Container		Mensagem a ser demonstrada no display
MessageDestination `<MsgDstn>`	[1..1]	CodeSet	n 4	A quem se destina a mensagem no contexto: “MDSP” = Mensagem para ser apresentada no display “CDSP“ – Mensagem para ser exibida no display do cliente
MessageContent `<MsgCntt>`	[1..1]	Text	ans 20000	Texto para ser exibido em display

Authorize (Autorização)

Introdução

👍
Exemplo.:

Tags da Mensagem de Requisição

📘
Info

Pedido de Autorização

❗️
Crédito à vista

Tags na Mensagem de Resposta

Introdução

👍Exemplo.:

Tags da Mensagem de Requisição

📘Info

Pedido de Autorização

❗️Crédito à vista

Tags na Mensagem de Resposta

👍
Exemplo.:

📘
Info

❗️
Crédito à vista