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.
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. |
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. |
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, |
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",
"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"
}
}
}
{
"items": [
{
"amount": 3000,
"description": "Chaveiro do Teressact",
"quantity": 1
}
],
"customer": {
"name": "Tony Stark"
},
"Submerchant": {
"Payment_Facilitator_Code": "55555",
"Merchant_Category_Code": "44444",
"Code": "code2",
"Name": "Sub Tony Stark",
"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"
}
},
"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.mundipagg.com",
"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",
"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"
}
]
}
Adquirentes integradas para envio das informações de Facilitadores de Pagamento
Stone, GetNet, Cielo 1.5, Cielo 3, ERede e SafraPay
Importante
Essa é uma determinação do Banco Central e das bandeiras e para saber quais dados são obrigatórios para sua integração entre em contato com sua adquirente.