Recursos para IA
Actualizar estado del consentimiento

Actualiza el estado de un consentimiento existente. El receptor primario puede cancelar (CANCELED) un consentimiento activo o pendiente.

PATCH

https://api.mercadopago.com/v1/split-consent/{receiver_id}
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
X-Idempotency-Key
string

REQUERIDO

Clave de idempotencia en formato UUIDv4. Garantiza que una misma solicitud no se procese más de una vez.
Path
receiver_id
string

REQUERIDO

Identificador único del consentimiento del receptor secundario (UUID generado al crear el consentimiento). Este valor se obtiene del campo receiver_id incluido en el array succeeded de la respuesta del POST /v1/split
Body
status
string
Nuevo estado del consentimiento. Actualmente solo se acepta CANCELED. Transiciones válidas: PENDING → CANCELED (por el receptor primario) y ACTIVE → CANCELED (por el receptor primario o secundario). Los estados REJECTED, EXPIRED y CANCELED son terminales: intentar cancelar desde esos estados retorna 409 con INVALID_TRANSITION.
PENDING: El receptor secundario recibió la invitación pero aún no la aceptó ni rechazó.
ACTIVE: El receptor secundario aceptó el consentimiento. El split de pagos está habilitado.
REJECTED: El receptor secundario rechazó la invitación.
Response parameters
receiver_id
string
Identificador único del consentimiento en formato UUID.
status
string
Estado actual del consentimiento.
PENDING: El receptor secundario recibió la invitación pero aún no la aceptó ni rechazó.
ACTIVE: El receptor secundario aceptó el consentimiento. El split de pagos está habilitado.
REJECTED: El receptor secundario rechazó la invitación.
created_at
string
Fecha y hora de creación del consentimiento (ISO 8601).
updated_at
string
Fecha y hora de la última actualización del consentimiento (ISO 8601).
Errors

400X-Idempotency-Key ausente o no es un UUIDv4 válido. Genera un UUIDv4 nuevo y envíalo en el header X-Idempotency-Key.

409Conflicto en la solicitud. Puede ocurrir por dos motivos: (1) Clave de idempotencia reutilizada con payload diferente: si necesitas reintentar con datos distintos, genera una nueva X-Idempotency-Key; si la solicitud es idéntica, reutiliza la misma clave. (2) Transición de estado inválida (INVALID_TRANSITION): el consentimiento está en un estado terminal (REJECTED, EXPIRED o CANCELED) y no puede cancelarse.

423Solicitud concurrente con la misma clave de idempotencia en curso. Espera a que la solicitud en curso finalice antes de volver a intentar.

Request
curl -X PATCH \
    'https://api.mercadopago.com/v1/split-consent/{receiver_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
       -H 'X-Idempotency-Key: cb9d1d7f-1026-4795-a18b-f815cce59730' \
    -d '{
  "status": "CANCELED"
}'
Response
{
  "receiver_id": "550e8400-e29b-41d4-a716-446655440001",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-16T08:00:00Z"
}