Por determinação do Banco Central e das bandeiras os cliente de E-commerce que se enquadram na categoria de Facilitadores de Pagamento deverão enviar dados referentes aos seus sub credenciados em cada requisição transacional.
Adquirentes integradas para envio das informações de Facilitadores de Pagamento
Stone, GetNet, Cielo 1.5, Cielo 3, PagSeguro, ERede e SafraPay.
IMPORTANTE
Para operar como Subadquirente na Stone, é fundamental que você realize o seu credenciamento para este modelo de operação antes de iniciar a integração técnica com os dados desta documentação.
O primeiro passo é acionar seu contato comercial para que ele possa orientá-lo em todas as etapas do processo.
Lembre-se que uma nova Subadquirente deve ser registrada nas bandeiras de cartão (ex: Mastercard, Visa, Elo e Amex) e existem regras específicas para essa atuação. O não cumprimento de todas as etapas de aprovação poderá sujeitá-lo a penalidades e multas aplicadas pelas bandeiras.
Para as demais, consulte sua adquirente.
O objeto SubMerchant possibilita o envio de informação de sub credenciados.
Um SubMerchant possui os seguintes atributos:
| Atributos | Tipo | Descrição |
|---|---|---|
SubMerchant | object | Dados de sub credenciador |
Merchant_Category_Code | string | MCC do subcredenciado - Código de categoria do estabelecimento comercial. Limite de quatro dígitos. Mais informações das regras de MCC para subadquirentes na Stone aqui. Para outras, consulte sua adquirente. |
Payment_Facilitator_Code | string | Código de identificação do Facilitador de pagamentos cadastrado com as bandeiras |
Code | string | Código de identificação do sub credenciado para o facilitador de pagamentos |
Name | string | Nome do sub credenciado. |
Legal_name | string | Razão social do sub credenciado. Observação: Campo será disponibilizado até o dia 04/04 |
Document | string | CPF ou CNPJ do sub credenciado. |
Type | string | Tipo de sub credenciado. Valores possíveis: individual e company. |
Phones | object | Telefones do sub credenciado. |
Phone_Type | string | Tipo do telefone do sub credenciado. |
Coutry_code | string | Código do País (Apenas numérico). |
Area_code | string | Código da área (Apenas numérico). |
Number | string | Número do telefone (Apenas numérico). |
Address | object | Endereço do sub credenciado. |
Country | string | País (Código do país no formato ISO 3166-1 alpha-2). |
State | string | Estado. (Código do estado no formato ISO 3166-2). |
City | string | Cidade. |
Neighborhood | string | Bairro. |
Street | string | Rua. |
Number | string | Número da rua. |
Complement | string | Complemento. |
Zip_Code | string | Código Postal (CEP) (Apenas numérico). |
{
"submerchant": {
"merchant_category_code": "4444",
"payment_facilitator_code": "5555555",
"code": "code2",
"name": "sub tony stark",
"legal_name": "empresa ltda",
"document": "123456789",
"type": "individual",
"phone": {
"country_code": "55",
"number": "000000000",
"area_code": "21"
},
"address": {
"street": "malibu point",
"number": "10880",
"complement": "a",
"neighborhood": "central malibu",
"city": "malibu",
"state": "ca",
"country": "us",
"zip_code": "24210460"
}
},
"items": [
{
"amount": 2990,
"description": "chaveiro do tesseract",
"quantity": 1
}
],
"customer": {
"name": "tony stark",
"email": "{{email}}"
},
"ip": "192.168.0.1",
"location": {
"latitude": "10",
"longitude": "20"
},
"session_id": "session_id_test",
"device": {
"platform": "android os"
},
"payments": [
{
"payment_method": "credit_card",
"credit_card": {
"installments": 1,
"statement_descriptor": "avengers",
"card": {
"number": "4000000000000010",
"holder_name": "tony stark",
"exp_month": 1,
"exp_year": 25,
"cvv": "351",
"billing_address": {
"street": "malibu point",
"number": "10880",
"zip_code": "90265",
"neighborhood": "central malibu",
"city": "malibu",
"state": "ca",
"country": "us"
}
}
}
}
],
"shipping": {
"amount": 110,
"description": "teste",
"recipient_name": "marcelo",
"type": "standard",
"address": {
"street": "malibu point",
"number": "10882",
"zip_code": "90265",
"neighborhood": "central malibu",
"city": "malibu",
"state": "ca",
"country": "us"
}
}
}
{
"submerchant": {
"payment_facilitator_code": "55555",
"merchant_category_code": "44444",
"code": "code2",
"name": "sub tony stark",
"legal_name": "empresa ltda",
"document": "123456789",
"type": "individual",
"phone": {
"country_code": "55",
"number": "000000000",
"area_code": "21"
},
"address": {
"street": "malibu point",
"number": "10880",
"neighborhood": "central malibu",
"city": "malibu",
"state": "ca",
"country": "us",
"zip_code": "24210-460"
}
},
"items": [
{
"amount": 3000,
"description": "chaveiro do teressact",
"quantity": 1
}
],
"customer": {
"name": "tony stark"
},
"payments": [
{
"amount": 3000,
"payment_method": "checkout",
"checkout": {
"expires_in": 120,
"billing_address_editable": false,
"customer_editable": true,
"accepted_payment_methods": [
"credit_card"
],
"success_url": "https://www.pagar.me",
"credit_card": {
"installments": [
{
"number": 1,
"total": 3000
},
{
"number": 2,
"total": 3000
}
]
}
}
}
]
}
{
"submerchant": {
"payment_facilitator_code": "55555",
"merchant_category_code": "44444",
"code": "code2",
"name": "sub tony stark",
"legal_name": "empresa ltda",
"document": "123456789",
"type": "individual",
"phone": {
"country_code": "55",
"number": "000000000",
"area_code": "21"
},
"address": {
"street": "malibu point",
"number": "10880",
"neighborhood": "central malibu",
"city": "malibu",
"state": "ca",
"country": "us",
"zip_code": "24210-460"
}
},
"billing_type": "prepaid",
"items": [
{
"name": "premium",
"description": "sem anuncios",
"quantity": 1,
"pricing_scheme": {
"price": 1490
},
"discounts": [
{
"discount_type": "percentage",
"value": 10,
"description": "desconto 10% item sem anuncios"
}
],
"increments": [
{
"discount_type": "percentage",
"value": 20,
"description": "incremento 20% item sem anuncios"
}
]
},
{
"name": "silver",
"description": "com anuncios",
"quantity": 1,
"pricing_scheme": {
"price": 2000
},
"increments": [
{
"discount_type": "percentage",
"value": 20
}
]
}
],
"customer": {
"name": "tony stark",
"email": "[email protected]"
},
"card": {
"number": "4000000000000010",
"holder_name": "tony stark",
"exp_month": 1,
"exp_year": 22,
"cvv": "3531",
"billing_address": {
"street": "malibu point",
"number": "10880",
"zip_code": "90265",
"neighborhood": "central malibu",
"city": "malibu",
"state": "ca",
"country": "us"
}
},
"discounts": [
{
"discount_type": "percentage",
"value": 10,
"description": "desconto 10% assinatura sem anuncios"
}
],
"increments": [
{
"discount_type": "percentage",
"value": 20,
"description": "incremento 20% assinatura sem anuncios"
}
]
}