These docs are for v2.1. Click to read the latest docs for v4.1.

sub_merchant

O objeto sub_merchant é responsável por representar os dados e informações do Lojista que está recebendo a transação do lado Facilitador de Pagamento.

👍

Importante

O PagSeguro não realiza nenhuma ação de análise ou tratamento em cima desses dados, eles são de uso exclusivamente para encaminhamento á bandeira.

Descrição

CampoTipoDescrição
reference_idString (15 caracteres)Identificador próprio referente ao lojista atribuído na plataforma do sub-adquirente.
nameString (60 caracteres)Razão social do lojista na plataforma do sub-adquirente em caso de pessoa jurídica. Em casos de pessoa física, nome completo do lojista na plataforma do sub-adquirente.
tax_idString (11 ou 14 caracteres)Número do documento (CPF ou CNPJ) do lojista na plataforma do sub-adquirente. Apenas números devem ser informados (com ou sem máscara).
mccString (4 caracteres)Código de atuação comercial do lojista na plataforma do sub-adquirente (merchant category code). Apenas números devem ser informados. Bloqueio padrão para casos de MCC de alto risco. Exemplos: 0763, 5199.
addressObjetoObjeto Address contendo as informações de endereço do lojista na plataforma do sub-adquirente.
phonesLista de ObjetosObjeto Phone contendo uma lista de telefones de contato do lojista na plataforma do sub adquirente. É preciso ser informado para transações com a bandeira ELO.

Exemplo

{
 ...
  "sub_merchant": {
    "name": "João Souza",
    "reference_id": "ID123456789",
    "tax_id": "12345678908",
    "mcc": "1554",
    "address": {
      "country": "BRA",
      "region_code": "SP",
      "city": "Sao Paulo",
      "postal_code": "01452002",
      "street": "Avenida Brigadeiro Faria Lima",
      "number": "1384",
      "locality": "Pinheiros",
      "complement": "Apto 16"
    },
    "phones": [
      {
        "country": "55",
        "area": "11",
        "number": "911111111",
        "type": "MOBILE"
      }
    ]
  }
 ...
}