Get Voids

Returns all or specific voided (cancelled) authorizations of the order.

Path

GET /api/v3/orders/{orderNumber}/voids/{voidNumber}

Request Parameters

orderNumber
required

string

Order number

voidNumber
required

string

Void number

Responses

200 Success

RESPONSE SCHEMA:

cancellations

array

Array of the Cancellations objects

Array () [
cancellationNo

string > 50 Characters

Order number

cancellationAmount

number <double>

Amount of the cancelled items

cancellationItems

array

The list of items to be cancelled

Array () [
cancellationNumber

string > 50 Characters

Refund ID

productId
required

string > 100 Characters

Merchant Product identification number.

groupId

string > 50 Characters

Item group ID. The group this item belongs to. Provided by the merchant. Everything over 50 characters will be truncated.

description
required

string

Product name. For example "Black music player 64GB". Everything over 255 characters will be truncated.

type

string

Enum:PhysicalArticleDigitalArticleGiftCardDiscountShippingFeeSurchargeInfoSubscription

netUnitPrice
required

number <double>

Net unit price.

grossUnitPrice
required

number <double>

Gross price per item.

quantity
required

number <double>

Quantity. Use of integer is strongly proposed. If you want to use decimal, please contact your integration manager.

unitCode

string > 50 Characters

Unit code (for example pieces, liters, kilograms, etc.).

vatCategory

string

Enum:HighCategoryLowCategoryNullCategoryNoCategoryMiddleCategoryOtherCategory

Vat category

vatPercent
required

number <double>

Tax percent.

vatAmount
required

number <double>

Tax amount per item.

imageUrl

string > 2048 Characters

URL for the image of this product. It will be turned into a thumbnail and displayed in Riverty, on the invoice line next to the order item. The linked image must be a rectangle or square, width between 100 pixels and 1280 pixels. Supported image formats are: gif, jpeg (jpg), png, webp.

googleProductCategoryId

integer <int32>

Google product category ID.

googleProductCategory

string > 255 Characters

Indicates the category of the item based on the Google product taxonomy. Categorizing the product helps ensure that the ad is shown with the right search results.

merchantProductType

string > 255 Characters

Categorization used by Merchant as a complement to Google Taxonomy.

lineNumber

integer <int32>

Line number. The merchant may add a line number to each order item, to sort them in a particular order.

productUrl

string > 2048 Characters

URL to the product.

marketPlaceSellerId

string > 32 Characters

ID of an individual seller on a marketplace.

parentTransactionReference

string > 128 Characters

A unique reference provided to Riverty by a third party (merchant or Payment Service Provider). Identifies an entire order.

additionalInformation

string > 4096 Characters

Extended description of the order item.

specification

undefined

Specification.

serviceStart

string <date-time>

Capture start time.

serviceEnd

string <date-time>

Capture end time.

]
parentTransactionReference

string > 128 Characters

A unique reference provided to Riverty by a third party (merchant or Payment Service Provider). Identifies an entire order.

]
400 Model validation failed.

RESPONSE SCHEMA:

Array () [
type

string

Enum:BusinessErrorTechnicalErrorNotificationMessage

code

string > 100 Characters

Confirmation or error code

message

string > 4096 Characters

Message content

customerFacingMessage

string > 4096 Characters

Message to display to customer

actionCode

string

Enum:UnavailableAskConsumerToConfirmAskConsumerToReEnterDataOfferSecurePaymentMethodsRequiresSsnAskConsumerToIdentify

Action codes

fieldReference

string > 100 Characters

Reference to field that caused an error

]
401 Authorization has been denied for this request.

RESPONSE SCHEMA:

type

string

title

string

status

integer <int32>

detail

string

instance

string

429 Too many requests.

RESPONSE SCHEMA:

type

string

title

string

status

integer <int32>

detail

string

instance

string

500 Internal server error.

Please select an example:

Response Example

{
  "cancellations": [
    {
      "cancellationNo": "C0000033476",
      "cancellationAmount": 300,
      "cancellationItems": [
        {
          "productId": "4534-BLK-M",
          "description": "Leather jacket, Black, size M",
          "grossUnitPrice": 100,
          "netUnitPrice": 84,
          "quantity": 1,
          "vatPercent": 19,
          "vatAmount": 16,
          "imageUrl": "https://developer-sandbox.riverty.com/images/black_leather_jacket.jpg"
        },
        {
          "productId": "5745-GRY-M",
          "description": "Socks, Grey, Size M",
          "grossUnitPrice": 10,
          "netUnitPrice": 8.4,
          "quantity": 5,
          "vatPercent": 19,
          "vatAmount": 1.6,
          "imageUrl": "https://developer-sandbox.riverty.com/images/grey_socks.jpg"
        },
        {
          "productId": "3323-BRN-M",
          "description": "Woolen hat, brown, Size M",
          "grossUnitPrice": 30,
          "netUnitPrice": 25.21,
          "quantity": 1,
          "vatPercent": 19,
          "vatAmount": 4.79,
          "imageUrl": "https://developer-sandbox.riverty.com/images/brown_wool_hat.jpg"
        },
        {
          "productId": "SHIP",
          "description": "Shipping",
          "type": "ShippingFee",
          "grossUnitPrice": 5,
          "netUnitPrice": 4.2,
          "quantity": 1,
          "vatPercent": 19,
          "vatAmount": 0.8
        }
      ]
    }
  ]
}