chargeback-docs

Enriquecimento de Comerciante e Parceiro

Enviaremos uma notificação webhook (HTTP POST) no seguinte formato:

{
	"event": "merchant",
	"payload": {
		"contractDisputeId": "d492bhhnshts7160i570",
		"acquirerMerchantIdentifier": "004000000396144"
	}
}

Campos da Notificação Webhook

Campo	Tipo	Obrigatório	Descrição
event	string	Sim	Identificador do tipo de evento. Sempre “merchant” para solicitações de enriquecimento de comerciante
payload	object	Sim	Container para os dados de identificação do comerciante
payload.contractDisputeId	string	Sim	Identificador único interno da Tupi para o contrato de disputa
payload.acquirerMerchantIdentifier	string	Sim	Identificador único do adquirente para o comerciante

Você deve então nos enviar uma requisição HTTP POST para a URL de callback fornecida durante a configuração (entre em contato conosco se não tiver certeza de qual endpoint usar).

{
    "type": "merchant",
    "data": {
        "merchant": {
            "taxId": "11222333000123",
            "legalName": "ACME INC",
            "dbaName": "ACME Rocketz",
            "acquirerMerchantIdentifier": "002000200362510",
            "address": {
                "country": "BR",
                "postalCode": "12929662",
                "street": "Fourth Street",
                "number": "622",
                "complement": "Building A",
                "neighborhood": "Downtown",
                "state": "SP",
                "city": "Sample City"
            },
            "contact": {
                "name": "John Doe",
                "email": "contact@example.com",
                "phone": "5511955226677"
            }
        },
        "partner": {
            "taxId": "22333666000155",
            "legalName": "PARTNER EXAMPLE",
            "dbaName": "PARTNER EXAMPLE",
            "partnerAcquirerIdentifier": "002005500362123",
            "address": {
                "country": "BR",
                "postalCode": "12929662",
                "street": "Fourth Street",
                "number": "622",
                "complement": "Building A",
                "neighborhood": "Downtown",
                "state": "SP",
                "city": "Sample City"
            },
            "contact": {
                "name": "John Doe",
                "email": "contact@example.com",
                "phone": "5511955226677"
            }
        }
    }
}

Campos da Requisição de Callback

Campo	Tipo	Obrigatório	Descrição
type	string	Sim	Identificador do tipo de requisição. Sempre “merchant” para dados de comerciante
data	object	Sim	Container para dados do comerciante e parceiro
data.merchant	object	Sim	Objeto de informações do comerciante
data.partner	object	Não	Objeto de informações do parceiro (opcional)

Campos do Objeto Merchant

Campo	Tipo	Obrigatório	Descrição
taxId	string	Sim	Número de identificação fiscal do comerciante (CNPJ no Brasil)
legalName	string	Sim	Razão social oficial do comerciante
dbaName	string	Sim	Nome fantasia (nome comercial)
acquirerMerchantIdentifier	string	Sim	Identificador único do adquirente para o comerciante
address	object	Não	Informações de endereço do comerciante
contact	object	Sim	Informações de contato do comerciante

Campos do Objeto Partner

Campo	Tipo	Obrigatório	Descrição
taxId	string	Sim	Número de identificação fiscal do parceiro (CNPJ no Brasil)
legalName	string	Sim	Razão social oficial do parceiro
dbaName	string	Sim	Nome fantasia (nome comercial)
partnerAcquirerIdentifier	string	Sim	Identificador único do adquirente para o parceiro
address	object	Não	Informações de endereço do parceiro
contact	object	Sim	Informações de contato do parceiro

Campos do Objeto Address

Campo	Tipo	Obrigatório	Descrição
country	string	Sim	Código do país com duas letras (ISO 3166-1 alpha-2)
postalCode	string	Sim	Código postal/CEP
street	string	Sim	Nome da rua
number	string	Sim	Número do endereço
complement	string	Não	Informações adicionais do endereço (edifício, apartamento, etc.)
neighborhood	string	Sim	Nome do bairro ou distrito
state	string	Sim	Código do estado ou província
city	string	Sim	Nome da cidade

Campos do Objeto Contact

Campo	Tipo	Obrigatório	Descrição
name	string	Sim	Nome completo da pessoa de contato
email	string	Sim	Endereço de e-mail de contato
phone	string	Sim	Número de telefone de contato com código do país