Ir al contenido

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

Modifica el registro de un merchant de tu empresa por el merchant_id. Es también la forma de guardar el merchant_ref en un merchant que ya existía sin referencia (por ejemplo, uno registrado en el panel): después de eso, Crear o actualizar merchant y el Lote de merchants pasan a actualizarlo por la referencia.

PATCH https://api.rapidchargeback.com/api/v1/merchants/:merchant_id
Authorization: Basic base64(client_id:client_secret)
Content-Type: application/json

ParamTipoDescripción
merchant_idstring (UUID)El id del merchant

Cualquier campo de Crear o actualizar merchant, todos opcionales, con los mismos límites. on_name_conflict no existe aquí.

  • Envía solo lo que cambia. El campo que no vino queda como está; null o "" lo limpia (menos name).
  • Cuerpo vacío ({}): 422 VALIDATION_ERROR “Send at least one field”.
  • Nombre de otro merchant tuyo: 409 MERCHANT_DUPLICATE, con su merchant_id.
SituaciónRespuesta
El merchant no tiene referenciaGuarda la enviada
La enviada es igual a la guardadaNada cambia (unchanged, si ningún otro campo cambió)
El merchant ya tiene otra referencia409 MERCHANT_REF_IMMUTABLE: la referencia no se cambia
Otro merchant tuyo ya usa esa referencia409 MERCHANT_REF_TAKEN, con su merchant_id

La referencia no se cambia porque las transacciones y las entregas de webhook ya hechas con ella siguen apuntando al mismo merchant. Si dos merchants tienen que volverse uno, habla con el soporte de Rapid.

active o inactive. Es informativo: inactive no detiene alertas ni transacciones. Para dejar de recibir alertas de un merchant, solicita la desactivación de sus enrollments.


Guardar la referencia de tu sistema en un merchant que vino del panel:

Ventana de terminal
curl -X PATCH https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \
-H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ=" \
-H "Content-Type: application/json" \
-d '{ "merchant_ref": "PB-1001" }'

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",
"...": "registro completo"
},
"meta": { "result": "updated", "warnings": [] }
}

data es el registro completo, el mismo de Consultar merchant. meta.result es updated o unchanged (nada cambió, nada guardado); meta.warnings puede traer el aviso SERVICE_FIELDS_NOT_APPLIED (ver Aviso de dato que no se aplica en el momento).

HTTP/1.1 409 Conflict
{
"error": {
"code": "MERCHANT_REF_IMMUTABLE",
"message": "merchant_ref cannot be changed once set"
}
}
HTTPCódigoCuándo
404MERCHANT_NOT_FOUNDEl merchant no existe, es de otra empresa, o el id no es un UUID
409MERCHANT_DUPLICATEOtro merchant tuyo ya tiene el nombre
409MERCHANT_REF_IMMUTABLEEl merchant ya tiene otra referencia
409MERCHANT_REF_TAKENOtro merchant tuyo ya usa la referencia (params.merchant_id)
422VALIDATION_ERROR, FIELD_REQUIRED, FIELD_TOO_LONG, FIELD_INVALID, FIELD_INVALID_OPTIONVer Crear o actualizar merchant
403KYB_NOT_APPROVED, COMPANY_NOT_ACTIVE, COMPANY_BLOCKEDEmpresa sin registro aprobado, inactiva o bloqueada
429RATE_LIMIT_EXCEEDEDMás de 60 escrituras por minuto
503SERVICE_UNAVAILABLENo disponible temporalmente: repite después del Retry-After

  • Repetir es seguro: la misma edición de nuevo vuelve unchanged.
  • Actividad: cada modificación aparece en la Actividad del panel como hecha por la integración.