Skip to main content

Voyado Engage

Register a return

In Engage, a return is viewed as just another transaction, but with a different transactional status. So there is no direct connection between a purchase and a later return, it’s considered a new transaction and handled accordingly.

Some important points to remember:

  • The quantity field needs to be negative, reflecting the number of returned items.

  • The price on a return should be sent as a positive value of type "integer"

  • The line item type needs to have the value “RETURN”

In the same way as for a purchase, the payload is sent to the following endpoint:

POST /api/v2/receipts

Example payload

This example receipt is a return for a contact with the contact type “Member”. Note that quantity is negative, the price is positive and the line item type is “RETURN”.

  "contact": {
    "matchKey": "28972987289",
    "matchKeyType": "memberNumber",
    "contactType": "Member"
  "uniqueReceiptId": "20180909468464496",
  "receiptNumber": "468464496",
  "createdDate": "2018-09-09T12:05:23Z",
  "storeExternalId": "Store1337",
  "currency": "NOK",
  "exchangeRateToGroupCurrency": 1.0,
  "totalGrossPrice": -400.00,
  "paymentMethods": [{
    "type": "card",
    "description": "Debit Card",
    "value": -400.00
  "items": [{
    "type": "RETURN",
    "quantity": -2,
    "grossPaidPrice": 400.00,
    "taxAmount": 80.00,
    "taxPercent": 25.00,
    "sku": "10015563434",
    "articleNumber": "2324234",
    "articleName": "Ipsum Wool Jacket",
    "articleGroup": "Jackets",
    "marginPercent": "25.00",
    "awardsBonus": false