Pular para o conteúdo

↑↓ navegar ↵ abrir Ctrl↵ nova aba esc fechar

Devolve o cadastro completo de um merchant da sua empresa. Para achar o merchant_id, use Listar merchants (inclusive pelo merchant_ref, o ID do vendedor no seu sistema).

GET https://api.rapidchargeback.com/api/v1/merchants/:merchant_id
Authorization: Basic base64(client_id:client_secret)

ParamTipoDescrição
merchant_idstring (UUID)O id do merchant

Esta rota não aceita query params: qualquer parâmetro na URL é recusado com 422 VALIDATION_ERROR (Unknown field: <nome>).


Janela do terminal
curl https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \
-H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="

HTTP/1.1 200 OK
{
"data": {
"id": "00000000-0000-0000-0000-000000000001",
"name": "Loja Exemplo",
"merchant_ref": "PB-1001",
"status": "active",
"created_at": "2026-03-10T12:00:00.000Z",
"updated_at": "2026-11-06T12:00:00.000Z",
"store_name": "Loja Exemplo",
"merchant_url": "https://lojaexemplo.com",
"contact_phone": "+55 11 99999-0000",
"email": "contato@lojaexemplo.com",
"mcc": "5999",
"description": null,
"logo_url": null,
"terms": null,
"terms_url": "https://lojaexemplo.com/termos",
"refund_policy": null,
"refund_policy_url": "https://lojaexemplo.com/reembolso",
"customer_service_instructions": null,
"address_street": "Rua Exemplo",
"address_number": "100",
"address_city": "São Paulo",
"address_state": "SP",
"address_postal_code": "01000-000",
"address_country": "BRA"
}
}
CampoDescrição
id, name, merchant_ref, status, created_at, updated_atOs mesmos de Listar merchants
store_nameNome da loja como o portador conhece
merchant_urlSite da loja
contact_phoneTelefone de atendimento
emailE-mail de atendimento
mccCódigo do ramo da loja (ver MCC)
descriptionDescrição do que a loja vende
logo_urlEndereço do logo
terms, terms_urlTermos de uso (texto e endereço)
refund_policy, refund_policy_urlPolítica de reembolso (texto e endereço)
customer_service_instructionsComo o portador fala com a loja
address_street, address_number, address_city, address_state, address_postal_codeEndereço
address_countryPaís, código de 3 letras em maiúsculas (ex.: BRA)

Campo sem valor vem null. É o mesmo objeto que Criar ou atualizar merchant e Editar merchant devolvem.

HTTP/1.1 404 Not Found
{
"error": {
"code": "MERCHANT_NOT_FOUND",
"message": "Merchant not found"
}
}

O mesmo 404 vale para um merchant_id que não existe, que é de outra empresa ou que não é um UUID.