REST Example: Skipping or Restoring a Payment in a Subscription {#skip-restore-payment-ex}
==========================================================================================

Request

```
{
  "billingCyclesToSkip": [
    4,
    5
  ]
}
```

Response to a Successful Request

```
{
  "_links": {
    "self": {
      "href": "/rbs/v1/subscriptions/7713669249636014301951/payments",
      "method": "GET"
    },
    "update": {
      "href": "/rbs/v1/subscriptions/7713669249636014301951/payments",
      "method": "PUT"
    }
  },
  "submitTimeUtc": "2026-02-25T15:34:05.337Z",
  "status": "COMPLETED",
  "billingCyclesToSkip": [
    4,
    5
  ]
}
```

Response to an Unsuccessful Request

```
{
  "submitTimeUtc": "2026-02-25T14:27:42.216Z",
  "status": "INVALID_REQUEST",
  "reason": "INVALID_DATA",
  "message": "One or more fields in the request contains invalid data.",
  "details": [
    {
      "field": "billingCyclesToSkip",
      "reason": "UNMODIFIABLE_PAYMENT_SKIP_ATTEMPT_CYCLE: 1"
    }
  ]
}
```

Error Response

```
{
  "submitTimeUtc": "2026-02-25T14:29:19.160Z",
  "status": "NOT_FOUND",
  "reason": "INVALID_DATA",
  "message": "Subscription with given ID not found."
}
```

