Order cancellation

The Order cancellation resource is a special API endpoint by which an order can be cancelled. This means the order status changes to cancelled and the order is no longer valid.

Accepted methods

  • POST: Cancel an order.

Constraints

  • Cancelling an order requires the cancel permission. This is set by Paylogic.
  • Order was created using the same credentials as the ones used to cancel it.
  • Order is in a valid state.
  • Order does not have an associated payment recorded. Refunds are not supported through the API.

Data

Field name Type Description
order String The uri of the order you wish to cancel.
reason String The reason for cancelling this order.

POST example

[POST] https://shopping-api.paylogic.com/ordercancellation/
{
    'order': 'https://shopping-api.paylogic.com/orders/87a2195h3gd162fb35c5a3dbd7bapo1l',
    'reason': 'Reason for cancelling this order.'
}

Response

{
    "_links": {
        "curies": [
            { "name": "shop", "href": "https://shopping-api-docs.paylogic.com/documentation/{rel}.html", "templated": true, "type": "text/html" },
        ],
        "self": { "href": "https://shopping-api.paylogic.com/orders/87a2195h3gd162fb35c5a3dbd7bapo1l" },
        "profile": { "href": "https://shopping-api-docs.paylogic.com/documentation/order.html", "type": "text/html" },
        "payment": { "href": "https://payments.paylogic.com?redirect=https://psp.paylogic.com/consumer/123", "type": "text/html" },
        "shop:etickets": { "href": "https://download.paylogic.com/eticket/sdfsdf235r245wsdgfw5235", "type": "text/html" },
        "shop:ordercancellation": { "href": "https://shopping-api.paylogic.com/ordercancellation", "type": "text/html" }
    },
    "uid": "87a2195h3gd162fb35c5a3dbd7bapo1l",
    "reference": "525743",
    "created_date": "2014-05-01T12:15:00Z",
    "status": "cancelled",
    "product_selection": [
        {
            "product": "https://shopping-api.paylogic.com/products/12365478654238976585643567854323",
            "quantity": 3
        },
        {
            "product": "https://shopping-api.paylogic.com/products/456ghtr45tg678fe5rf456yhgbvsw3lh",
            "quantity": 1
        },
        {
            "parent": "https://shopping-api.paylogic.com/products/456ghtr45tg678fe5rf456yhgbvsw3lh",
            "product": "https://shopping-api.paylogic.com/products/267arnr45tg984rd5rf456opshwks0ol",
            "quantity": 1
        }
    ],
    "consumer": {
        "first_name": "John",
        "last_name": "Doe",
        "date_of_birth": "1986-12-30",
        "email": "john.doe@paylogic.eu",
        "gender": 1,
        "address": "Nieuwe Boteringestraat 28",
        "postal_code": "9716 JJ",
        "city": "Groningen",
        "country": "NL",
        "ip": "192.168.1.1"
    },
    "payment_method": {
        "uid": "ghr57d5h3gd162fb35c5a3db57ghrydg",
        "name": {"en": "iDeal", "nl": "", "de": "", "fr": "", "es": "", "pt": "", "tr": "", "ru": ""},
        "image": "https://static.paylogic.com/ideal.jpg",
        "costs": { "amount": 1.00, "currency": "EUR" }
    },
    "shipping_method": {
        "uid": "87a5quvndhe162fb357alt872705zr2j",
        "name": {"en": "Eticket", "nl": "", "de": "", "fr": "", "es": "", "pt": "", "tr": "", "ru": ""},
        "costs": { "amount": 0.50, "currency": "EUR" }
    },
    "product_total": { "amount": 13.50, "currency": "EUR" },
    "service_costs": { "amount": 1.50, "currency": "EUR" },
    "grand_total": { "amount": 16.50, "currency": "EUR" },
    "external_purchases": [
        {
            "title": {"en": "External purchase", "nl": "", "de": "", "fr": "", "es": "", "pt": "", "tr": "", "ru": ""},
            "product_reference": "External purchase product A",
            "unit_price": { "amount": 50.00, "currency": "EUR" },
            "quantity": 3
        }
    ]
    "external_reference": "CO-115",
    "_embedded": {
        "shop:product": [
            // ...
        ],
        "shop:ticket": [
            // ...
        ]
    }
}

POST error handling

Error types

Type HTTP Code Description
FORBIDDEN 403 Forbidden. No cancel permission or order has a payment.
NOT_FOUND 404 Not found. The order was not found.
BAD_REQUEST 400 Bad request. This can happen if the uid or reason are missing.
ORDER_ALREADY_CANCELED 409 Conflict. The order is already canceled.