Updates the status of an existing consent. The primary seller can cancel (CANCELED) an active or pending consent.
PATCH
REQUIRED
REQUIRED
REQUIRED
receiver_id field included in the succeeded array of the POST /v1/split-consent respoCANCELED is accepted. Valid transitions: PENDING → CANCELED (by the primary seller) and ACTIVE → CANCELED (by the primary or secondary seller). The statuses REJECTED, EXPIRED and CANCELED are terminal: attempting to cancel from those statuses returns 409 with INVALID_TRANSITION.400X-Idempotency-Key absent or not a valid UUIDv4. Generate a new UUIDv4 and send it in the X-Idempotency-Key header.
409Conflict in the request. Can occur for two reasons: (1) Idempotency key reused with a different payload: if you need to retry with different data, generate a new X-Idempotency-Key; if the request is identical, reuse the same key. (2) Invalid state transition (INVALID_TRANSITION): the consent is in a terminal status (REJECTED, EXPIRED or CANCELED) and cannot be canceled.
423Concurrent request with the same X-Idempotency-Key in progress. Wait for the in-progress request to complete before retrying.
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: 0b229cb2-1227-4553-84bc-d97f90fb6d3c' \
-d '{
"status": "CANCELED"
}'{
"receiver_id": "550e8400-e29b-41d4-a716-446655440001",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-16T08:00:00Z"
}