Atualiza o status de um consentimento existente. O receptor primário pode cancelar (CANCELED) um consentimento ativo ou pendente.
PATCH
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
receiver_id incluído no array succeeded da resposta do POST /v1/split-consent.CANCELED é aceito. Transições válidas: PENDING → CANCELED (pelo receptor primário) e ACTIVE → CANCELED (pelo receptor primário ou secundário). Os status REJECTED, EXPIRED e CANCELED são terminais: tentar cancelar a partir desses status retorna 409 com INVALID_TRANSITION.400X-Idempotency-Key ausente ou não é um UUIDv4 válido. Gere um UUIDv4 novo e envie-o no header X-Idempotency-Key.
409Conflito na requisição. Pode ocorrer por dois motivos: (1) Chave de idempotência reutilizada com payload diferente: se precisar retentar com dados distintos, gere uma nova X-Idempotency-Key; se a solicitação for idêntica, reutilize a mesma chave. (2) Transição de status inválida (INVALID_TRANSITION): o consentimento está em um status terminal (REJECTED, EXPIRED ou CANCELED) e não pode ser cancelado.
423Requisição concorrente com a mesma chave de idempotência em andamento. Aguarde a conclusão da requisição em curso antes de tentar novamente.
curl -X PATCH \
'https://api.mercadopago.com/v1/split-consent/{receiver_id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-H 'X-Idempotency-Key: d2bb8b18-a50e-4210-ace4-2e12b92d0cd5' \
-d '{
"status": "CANCELED"
}'{
"receiver_id": "550e8400-e29b-41d4-a716-446655440001",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-16T08:00:00Z"
}