--- title: "Autorização com dados de sublojistas (Stone Online)" url: "https://devcenter.stone.com.br/legacy-stone-online-autorizacao-com-dados-de-subadquirente" image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~QXV0b3JpemHDp8OjbyBjb20gZGFkb3MgZGUgc3VibG9qaXN0YXMgKFN0b25lIE9ubGluZSk,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktc3RvbmUtb25saW5lLWF1dG9yaXphY2FvLWNvbS1kYWRvcy1kZS1zdWJhZHF1aXJlbnRlIg,s__eNV5ubT5_Tcqro0.png" --- # Autorização com dados de sublojistas Documentação legada · Produtos e Tipos de transação Documentação legada do Stone Online Esta página descreve a **API Stone Online** (versão legada). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**. ## [Introdução](#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 objeto `sub_merchant`(Contém os dados de sublojista/sub-merchant) dentro de `Charge` (Traz contexto para a venda). ## [Objeto sub\_merchant](#objeto-sub_merchant) | Campo | Tipo | Tamanho | Descrição | | :------------ | :-------- | :------ | :------------------------------------------------------------------------------- | | id | string | - | Identificador do sublojista atribuído pela Subadquirente | | name | string | - | Nome Fantasia do sublojista | | legal_name | string | - | Razão Social do sublojista | | document | string | 14 | Documento do sublojista cadastrado com a adquirente, sem separadores. | | document_type | string | - | Tipo de documento usado no cadastro com a adquirenteValores possiveis: cpf, cnpj, passport | | email | string | - | Endereço eletrônico do sublojista | | phone_number | string | - | Número de telefone do sublojista | | site | string | - | Endereço do ecommerce do sublojista | | address | container | - | Endereço de cobrança do sublojista | ## [Objeto address](#objeto-address) | Campo | Tipo | Tamanho | Descrição | | :----------- | :----- | :------- | :------------------------------------------------------------------------------- | | street | string | ans 3-11 | Rua do endereço (mínimo de 3 e máximo de 90 caracteres) | | number | string | - | Número do endereço | | complement | string | - | Campo para adicionar informações complementares do endereço. | | city | string | - | Cidade do endereço | | district | string | - | Bairro do endereço | | state | string | a-2 | Estado do endereço (sigla) | | country_code | string | - | Codigo do pais. Padrão ISO 3166. Quando não informado será considerado o valor default "076" (Brasil) | | zip_code | string | - | Código postal do endereço, sem separadores ou espaçamento | Além dos dados recebidos nesse container, há dois campos que precisam ser populadas com dados do sublojista, são elas: - `statement_descriptor` - Nome que irá na fatura do portador, junto ao identificador da subadquirente já cadastrado na Stone. Importante: o identificador da subadquirente não precisa ser enviado na requisição. - Para transações da bandeira **Mastercard** será necessário identificar na autorização, se o estabelecimento comercial faz parte do seguimento de casas de câmbio. (Exemplo: nomedomerchant\*cambio) - `merchant_category_code` - MCC (merchant category code) do sub-merchant (corresponde ao tipo de atividade do CNAE do sub-merchant). ## [Request](#request) Abaixo está um exemplo de uma transação com dados de sublojista e suas respostas. ```json { "amount": 1000, "initiator_id": "6c581baae0df4cb6", "local_datetime": "2024-04-10T15:46:47", "payment_method": "card", "channel": "website", "card_transaction": { "type": "credit", "operation_type": "auth_and_capture", "statement_descriptor": "loja ecommerce", "card": { "entry_mode": "manual", "expiration_date": "5012", "number": "6033401111633077000", "track_2": "6033401111633077000=31116000018400040", "holder_name": "TONY STARK" }, "merchant_category_code": 5818 }, "sub_merchant": { "id": "254759", "name": "Mkt*subloja", "legal_name": "subloja LTDA", "document": "02326943001", "document_type": "cnpj", "email": "email@email.com", "phone_number": "+551130041234", "address": { "street": "Rua Presidente Getúlio Vargas", "number": "123", "complement": "2ª andar - sala 1", "state": "SC", "city": "Porto Alegre", "country_code": "076", "zip_code": "90050000" } } } ``` ```json { "id": "B7843C6C57836C5ETWGFU", "initiator_id": "1470375860-3.19.3.3-RG0DA3-0001", "reference_id": "787CVBNBN794", "amount": 923, "status": "authorized", "payment_method": "card", "created_at": "2023-07-01T11:50:37Z", "card_transaction": { "type": "credit", "funding_source": "credit", "result": "success", "transaction_id": "cb42d188-aca6-46f2-a2c9-046cb6342f5d", "operation_id": "4d41314b-cb2d-4abe-b594-fd6875726e1b", "authorization_code": "ABC416", "acquirer_message": "Aprovado", "acquirer_return_code": "0000", "card": { "brand": "Visa", "emv_response": "9F0500" } } } ``` --- **Jornada: [Transações de ecommerce](https://devcenter.stone.com.br/legacy-stone-online-digital)** Etapa 5 de 15 [**Etapa anterior**Autorização voucher](https://devcenter.stone.com.br/legacy-stone-online-autorizacao-voucher)[**Próxima etapa**Autorização com credential on file](https://devcenter.stone.com.br/legacy-stone-online-autorizacao-com-credential-on-file-copy) Siga a Stone nas redes sociais [](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ) © Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57 Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.