Docs

Refund Consumption

Refund consumption.

Path

PUT /v1/clients/{clientId}/consumptions/{consumptionId}/refunds/{refundId}

Request Parameters

clientId

required

integer

Your assigned `ClientId`.

consumptionId

required

string

Id of the consumption.

refundId

required

string

Id of the refund.

Responses

type

required

string

The type of error that is carried within this response. The value of this type is an URI that can be dereferenced for a human-readable explanation of the error type.

category

required

string

Enum:

BUSINESS_ERROR

TECHNICAL_ERROR

Category of the error, used primarily to determine whether the same request should be retried or not. Possible values: * `BUSINESS_ERROR` - A business error occured. This request should *not* be retried without modification * `TECHNICAL_ERROR` - A temporary, technical error occurred. the request *should* be retried after a back-off period.

title

string

A short, human-readable summary of the problem.

message

string

A short, human-readable summary of the problem. Identical to `title`.

type

required

string

The type of error that is carried within this response. The value of this type is an URI that can be dereferenced for a human-readable explanation of the error type.

category

required

string

Enum:

BUSINESS_ERROR

TECHNICAL_ERROR

Category of the error, used primarily to determine whether the same request should be retried or not. Possible values: * `BUSINESS_ERROR` - A business error occured. This request should *not* be retried without modification * `TECHNICAL_ERROR` - A temporary, technical error occurred. the request *should* be retried after a back-off period.

title

string

A short, human-readable summary of the problem.

message

string

A short, human-readable summary of the problem. Identical to `title`.

required

array

A list of validation failures for the request.

Successful Request

Unsuccessful Request, Incorrect/Missing Information

Request Example

    
        null

Response Example

    
        {
 "consumptionTotal": {
  "currencyCode": "NOK",
  "grossAmount": 125,
  "vatAmount": 25
 },
 "refundTotal": {
  "currencyCode": "NOK",
  "grossAmount": 25,
  "vatAmount": 25
 }
}

Request Example

    
        null

Response Example

    
        {
 "type": "https://developer.riverty.io/errors/subscription/error-type",
 "category": "BUSINESS_ERROR",
 "title": "A description of the problem",
 "message": "A description of the problem"
}