Consultar merchant
Devuelve el registro completo de un merchant de tu empresa. Para encontrar el merchant_id, usa Listar merchants (también por el merchant_ref, el ID del vendedor en tu sistema).
Endpoint
Sección titulada «Endpoint»GET
https://api.rapidchargeback.com/api/v1/merchants/:merchant_idAutenticación
Sección titulada «Autenticación»Authorization: Basic base64(client_id:client_secret)Parámetros de URL
Sección titulada «Parámetros de URL»| Param | Tipo | Descripción |
|---|---|---|
merchant_id | string (UUID) | El id del merchant |
Esta ruta no acepta query params: cualquier parámetro en la URL se rechaza con 422 VALIDATION_ERROR (Unknown field: <nombre>).
Ejemplo de solicitud
Sección titulada «Ejemplo de solicitud»curl https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Respuesta
Sección titulada «Respuesta»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 | Descripción |
|---|---|
id, name, merchant_ref, status, created_at, updated_at | Los mismos de Listar merchants |
store_name | Nombre de la tienda como la conoce el titular |
merchant_url | Sitio de la tienda |
contact_phone | Teléfono de atención |
email | Correo de atención |
mcc | Código del rubro de la tienda (ver MCC) |
description | Descripción de lo que vende la tienda |
logo_url | Dirección del logo |
terms, terms_url | Términos de uso (texto y dirección) |
refund_policy, refund_policy_url | Política de reembolso (texto y dirección) |
customer_service_instructions | Cómo el titular contacta a la tienda |
address_street, address_number, address_city, address_state, address_postal_code | Dirección |
address_country | País, código de 3 letras en mayúsculas (ej.: BRA) |
El campo sin valor viene null. Es el mismo objeto que devuelven Crear o actualizar merchant y Editar merchant.
Merchant no encontrado
Sección titulada «Merchant no encontrado»HTTP/1.1 404 Not Found{ "error": { "code": "MERCHANT_NOT_FOUND", "message": "Merchant not found" }}El mismo 404 vale para un merchant_id que no existe, que es de otra empresa o que no es un UUID.
- Solo los merchants de tu empresa. La empresa viene de la credencial.
- Auth, rate limit, códigos de error: ver Autenticación y Códigos de respuesta.