Ir al contenido

↑↓ navegar ↵ abrir Ctrl↵ nueva pestaña esc cerrar

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).

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

ParamTipoDescripción
merchant_idstring (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>).


Ventana de 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"
}
}
CampoDescripción
id, name, merchant_ref, status, created_at, updated_atLos mismos de Listar merchants
store_nameNombre de la tienda como la conoce el titular
merchant_urlSitio de la tienda
contact_phoneTeléfono de atención
emailCorreo de atención
mccCódigo del rubro de la tienda (ver MCC)
descriptionDescripción de lo que vende la tienda
logo_urlDirección del logo
terms, terms_urlTérminos de uso (texto y dirección)
refund_policy, refund_policy_urlPolítica de reembolso (texto y dirección)
customer_service_instructionsCómo el titular contacta a la tienda
address_street, address_number, address_city, address_state, address_postal_codeDirección
address_countryPaí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.

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.