Consultar merchant
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).
Endpoint
Seção intitulada “Endpoint”GET
https://api.rapidchargeback.com/api/v1/merchants/:merchant_idAutenticação
Seção intitulada “Autenticação”Authorization: Basic base64(client_id:client_secret)Parâmetros de URL
Seção intitulada “Parâmetros de URL”| Param | Tipo | Descrição |
|---|---|---|
merchant_id | string (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>).
Exemplo de requisição
Seção intitulada “Exemplo de requisição”curl https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Resposta
Seção intitulada “Resposta”Sucesso
Seção intitulada “Sucesso”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" }}| Campo | Descrição |
|---|---|
id, name, merchant_ref, status, created_at, updated_at | Os mesmos de Listar merchants |
store_name | Nome da loja como o portador conhece |
merchant_url | Site da loja |
contact_phone | Telefone de atendimento |
email | E-mail de atendimento |
mcc | Código do ramo da loja (ver MCC) |
description | Descrição do que a loja vende |
logo_url | Endereço do logo |
terms, terms_url | Termos de uso (texto e endereço) |
refund_policy, refund_policy_url | Política de reembolso (texto e endereço) |
customer_service_instructions | Como o portador fala com a loja |
address_street, address_number, address_city, address_state, address_postal_code | Endereço |
address_country | Paí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.
Merchant não encontrado
Seção intitulada “Merchant não encontrado”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.
- Só os merchants da sua empresa. A empresa vem da credencial.
- Auth, rate limit, códigos de erro: ver Autenticação e Códigos de resposta.