# Update consent status

Updates the status of an existing consent. The primary seller can cancel (`CANCELED`) an active or pending consent.

**PATCH** `/v1/split-consent/{receiver_id}`

## Request parameters

### Header

- `X-Idempotency-Key` (string, required)
  Idempotency key in UUIDv4 format. Ensures the same request is not processed more than once.

### Path

- `receiver_id` (string, required)
  Unique identifier of the secondary seller's consent (UUID generated when the consent was created). This value is obtained from the `receiver_id` field included in the `succeeded` array of the POST /v1/split-consent response.

- `status` (string, required)
  New consent status. Currently only `CANCELED` 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`.
Possible enum values:

  - `PENDING`
  The secondary seller received the invitation but has not yet accepted or rejected it.

  - `ACTIVE`
  The secondary seller accepted the consent. Split payments are enabled.

  - `REJECTED`
  The secondary seller rejected the invitation.

  - `CANCELED`
  The primary seller canceled the consent.

  - `EXPIRED`
  The invitation expired without a response within the established deadline.

## Response parameters

- `receiver_id` (string, required)
  Unique consent identifier in UUID format.

- `status` (string, required)
  Current status of the consent.
Possible enum values:

  - `PENDING`
  The secondary seller received the invitation but has not yet accepted or rejected it.

  - `ACTIVE`
  The secondary seller accepted the consent. Split payments are enabled.

  - `REJECTED`
  The secondary seller rejected the invitation.

  - `CANCELED`
  The primary seller canceled the consent.

  - `EXPIRED`
  The invitation expired without a response within the established deadline.

- `created_at` (string, required)
  Consent creation date and time (ISO 8601).

- `updated_at` (string, optional)
  Last consent update date and time (ISO 8601).

## Errors

| Status | Error | Description |
| ------- | ------- | ----------- |
| 400 | — | X-Idempotency-Key absent or not a valid UUIDv4. Generate a new UUIDv4 and send it in the X-Idempotency-Key header. |
| 409 | — | Conflict 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. |
| 423 | — | Concurrent request with the same X-Idempotency-Key in progress. Wait for the in-progress request to complete before retrying. |

## Request example

### cURL

```bash
curl -X PATCH \
  'https://api.mercadopago.com/v1/split-consent/{receiver_id}' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -d '{
  "status": "CANCELED"
  }'
```

## Response example

```json
{
  "receiver_id": "550e8400-e29b-41d4-a716-446655440001",
  "status": "PENDING",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-16T08:00:00Z"
}
```