---
agentTools:
  projectIndex: https://docs.mundipagg.com/llms.txt
---

# Facilitadores de pagamento (Dados de Subadquirente)

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:

[block:parameters]
{
  "data": {
    "0-0": "`SubMerchant`",
    "1-0": "`Merchant_Category_Code`",
    "2-0": "`Payment_Facilitator_Code`",
    "3-0": "`Code`",
    "4-0": "`name`",
    "5-0": "`Document`",
    "h-0": "Atributos",
    "h-1": "Tipo",
    "h-2": "Descrição",
    "0-1": "**object**",
    "6-0": "`Type`",
    "7-0": "`phones`",
    "8-0": "`Coutry_code`",
    "10-0": "`Number`",
    "7-1": "**object**",
    "4-1": "**string**",
    "5-1": "**string**",
    "6-1": "**string**",
    "7-2": "Telefones do sub credenciado,",
    "11-0": "`Address`",
    "12-0": "`Country`",
    "13-0": "`State`",
    "14-0": "`City`",
    "15-0": "`Neighborhood`",
    "16-0": "`Street`",
    "17-0": "`Number`",
    "18-0": "`Complement`",
    "19-0": "`Zip_Code`",
    "0-2": "Dados de sub credenciador",
    "1-2": "MCC do subcredenciado - Código de categoria do estabelecimento comercial. Limite de quatro dígitos.",
    "1-1": "**string**",
    "2-1": "**string**",
    "3-1": "**string**",
    "2-2": "Código de identificação do Facilitador de pagamentos cadastrado com as bandeiras",
    "3-2": "Código de identificação do sub credenciado para o facilitador de pagamentos",
    "4-2": "Nome do  sub credenciado.",
    "5-2": "CPF ou CNPJ do sub credenciado.",
    "6-2": "Tipo de sub credenciado. Valores possíveis: `individual` e `company`.",
    "8-1": "**string**",
    "10-1": "**string**",
    "11-1": "**object**",
    "12-1": "**string**",
    "13-1": "**string**",
    "14-1": "**string**",
    "15-1": "**string**",
    "16-1": "**string**",
    "17-1": "**string**",
    "18-1": "**string**",
    "19-1": "**string**",
    "8-2": "Código do País (Apenas numérico).",
    "10-2": "Número do telefone (Apenas numérico).",
    "9-0": "`Area_code`",
    "9-1": "**string**",
    "9-2": "Código da área (Apenas numérico).",
    "19-2": "Código Postal (CEP)\n(Apenas numérico).",
    "14-2": "_Cidade_.",
    "15-2": "_Bairro_.",
    "13-2": "_Estado_.\n(Código do estado no formato ISO 3166-2).",
    "12-2": "País (Código do país no formato ISO 3166-1 alpha-2).",
    "16-2": "_Rua_.",
    "17-2": "_Número da rua_.",
    "18-2": "_Complemento_.",
    "11-2": "Endereço do sub credenciado."
  },
  "cols": 3,
  "rows": 20
}
[/block]

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"Submerchant\": {\n    \t\"Merchant_Category_Code\":\"4444\",\n    \t\"Payment_Facilitator_Code\":\"5555555\",\n        \"Code\": \"code2\",\n        \"Name\": \"Sub Tony Stark\",\n        \"Document\": \"123456789\",\n        \"Type\": \"individual\",\n        \"Phone\": {\n            \"Country_Code\": \"55\",\n            \"Number\": \"000000000\",\n            \"Area_Code\": \"21\"\n        },\n        \"Address\": {\n            \"Street\": \"Malibu Point\",\n            \"Number\": \"10880\",\n            \"Complement\": \"A\",\n            \"Neighborhood\": \"Central Malibu\",\n            \"City\": \"Malibu\",\n            \"State\": \"CA\",\n            \"Country\": \"US\",\n            \"zip_code\": \"24210460\"\n        }\n    },\n    \"items\": [\n        {\n            \"amount\": 2990,\n            \"description\": \"Chaveiro do Tesseract\",\n            \"quantity\": 1\n        }\n    ],\n    \"customer\": {\n        \"name\": \"Tony Stark\",\n        \"email\": \"{{email}}\"\n    },\n    \"ip\": \"192.168.0.1\",\n    \"location\": {\n        \"latitude\": \"10\",\n        \"longitude\": \"20\"\n    },\n    \"session_id\": \"session_id_test\",\n    \"device\": {\n        \"platform\": \"ANDROID OS\"\n    },\n    \"payments\": [\n        {\n            \"payment_method\": \"credit_card\",\n            \"credit_card\": {\n                \"installments\": 1,\n                \"statement_descriptor\": \"AVENGERS\",\n                \"card\": {\n                    \"number\": \"4000000000000010\",\n                    \"holder_name\": \"Tony Stark\",\n                    \"exp_month\": 1,\n                    \"exp_year\": 25,\n                    \"cvv\": \"351\",\n                    \"billing_address\": {\n                        \"street\": \"Malibu Point\",\n                        \"number\": \"10880\",\n                        \"zip_code\": \"90265\",\n                        \"neighborhood\": \"Central Malibu\",\n                        \"city\": \"Malibu\",\n                        \"state\": \"CA\",\n                        \"country\": \"US\"\n                    }\n                }\n            }\n        }\n    ],\n    \"shipping\": {\n        \"amount\": 110,\n        \"description\": \"teste\",\n        \"recipient_name\": \"Marcelo\",\n        \"type\": \"standard\",\n        \"address\": {\n            \"street\": \"Malibu Point\",\n            \"number\": \"10882\",\n            \"zip_code\": \"90265\",\n            \"neighborhood\": \"Central Malibu\",\n            \"city\": \"Malibu\",\n            \"state\": \"CA\",\n            \"country\": \"US\"\n        }\n    }\n}",
      "language": "json",
      "name": "Create Order"
    },
    {
      "code": "{\n    \"items\": [\n        {\n            \"amount\": 3000,\n            \"description\": \"Chaveiro do Teressact\",\n            \"quantity\": 1\n        }\n    ],\n    \"customer\": {\n        \"name\": \"Tony Stark\"\n    },\n    \"Submerchant\": {\n        \"Payment_Facilitator_Code\": \"55555\",\n        \"Merchant_Category_Code\": \"44444\",\n        \"Code\": \"code2\",\n        \"Name\": \"Sub Tony Stark\",\n        \"Document\": \"123456789\",\n        \"Type\": \"individual\",\n        \"Phone\": {\n            \"Country_Code\": \"55\",\n            \"Number\": \"000000000\",\n            \"Area_Code\": \"21\"\n        },\n        \"Address\": {\n            \"Street\": \"Malibu Point\",\n            \"Number\": \"10880\",\n            \"Neighborhood\": \"Central Malibu\",\n            \"City\": \"Malibu\",\n            \"State\": \"CA\",\n            \"Country\": \"US\",\n            \"zip_code\": \"24210-460\"\n        }\n    },\n    \"payments\": [\n        {\n            \"amount\": 3000,\n            \"payment_method\": \"checkout\",\n            \"checkout\": {\n                \"expires_in\": 120,\n                \"billing_address_editable\": false,\n                \"customer_editable\": true,\n                \"accepted_payment_methods\": [\n                    \"credit_card\"\n                ],\n                \"success_url\": \"https://www.mundipagg.com\",\n                \"credit_card\": {\n                    \"installments\": [\n                        {\n                            \"number\": 1,\n                            \"total\": 3000\n                        },\n                        {\n                            \"number\": 2,\n                            \"total\": 3000\n                        }\n                    ]\n                }\n            }\n        }\n    ]\n}",
      "language": "json",
      "name": "Create Order - Checkout"
    },
    {
      "code": "{\n    \"Submerchant\": {\n    \t\"Payment_Facilitator_Code\":\"55555\",\n    \t\"Merchant_Category_Code\": \"44444\",\n        \"Code\": \"code2\",\n        \"Name\": \"Sub Tony Stark\",\n        \"Document\": \"123456789\",\n        \"Type\": \"individual\",\n        \"Phone\": {\n            \"Country_Code\": \"55\",\n            \"Number\": \"000000000\",\n            \"Area_Code\": \"21\"\n        },\n        \"Address\": {\n            \"Street\": \"Malibu Point\",\n            \"Number\": \"10880\",\n            \"Neighborhood\": \"Central Malibu\",\n            \"City\": \"Malibu\",\n            \"State\": \"CA\",\n            \"Country\": \"US\",\n            \"zip_code\": \"24210-460\"\n        }\n    },\n    \"billing_type\": \"prepaid\",\n    \"items\": [\n        {\n            \"name\": \"Premium\",\n            \"description\": \"Sem anuncios\",\n            \"quantity\": 1,\n            \"pricing_scheme\": {\n                \"price\": 1490\n            },\n            \"discounts\": [\n                {\n                    \"discount_type\": \"percentage\",\n                    \"value\": 10,\n                    \"description\": \"Desconto 10% Item Sem Anuncios\"\n                }\n            ],\n            \"increments\": [\n                {\n                    \"discount_type\": \"percentage\",\n                    \"value\": 20,\n                    \"description\": \"Incremento 20% Item Sem Anuncios\"\n                }\n            ]\n        },\n        {\n            \"name\": \"Silver\",\n            \"description\": \"Com anuncios\",\n            \"quantity\": 1,\n            \"pricing_scheme\": {\n                \"price\": 2000\n            },\n            \"increments\": [\n                {\n                    \"discount_type\": \"percentage\",\n                    \"value\": 20\n                }\n            ]\n        }\n    ],\n    \"customer\": {\n        \"name\": \"Tony Stark\",\n        \"email\": \"mail@maaail.cm\"\n    },\n    \"card\": {\n        \"number\": \"4000000000000010\",\n        \"holder_name\": \"Tony Stark\",\n        \"exp_month\": 1,\n        \"exp_year\": 22,\n        \"cvv\": \"3531\",\n        \"billing_address\": {\n            \"street\": \"Malibu Point\",\n            \"number\": \"10880\",\n            \"zip_code\": \"90265\",\n            \"neighborhood\": \"Central Malibu\",\n            \"city\": \"Malibu\",\n            \"state\": \"CA\",\n            \"country\": \"US\"\n        }\n    },\n    \"discounts\": [\n        {\n            \"discount_type\": \"percentage\",\n            \"value\": 10,\n            \"description\": \"Desconto 10% Assinatura Sem Anuncios\"\n        }\n    ],\n    \"increments\": [\n        {\n            \"discount_type\": \"percentage\",\n            \"value\": 20,\n            \"description\": \"Incremento 20% Assinatura Sem Anuncios\"\n        }\n    ]\n}",
      "language": "json",
      "name": "Create Subscription"
    }
  ]
}
[/block]

[block:callout]
{
  "type": "info",
  "title": "Adquirentes integradas para envio das informações de Facilitadores de Pagamento",
  "body": "Stone, GetNet, Cielo 1.5, Cielo 3, ERede e SafraPay"
}
[/block]

[block:callout]
{
  "type": "warning",
  "title": "Importante",
  "body": "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."
}
[/block]