Get

/order

Target audience: Developers

Introduction

This endpoint returns one or several orders, details for them along with payments.

URI

Environment URI
Stage https://payway-api.stage.adeprimo.se/external/api/v1/order
Production https://backend.worldoftulo.com/external/api/v1/order

Requirements

Identity Scope
No /external/order/r

Parameters

Name Description
order_id The id of the order to get
account_id The id of the account to get orders from

Curl Example

Get an order

1
2
3
4
curl --request GET \
  --url https://payway-api.stage.adeprimo.se/external/api/v1/order?order_id=ADEPRIMO-123 \
  --header 'accept: application/json' \
  --header 'authorization: Bearer token' \

Get orders for account

1
2
3
4
curl --request GET \
  --url https://payway-api.stage.adeprimo.se/external/api/v1/order?account_id=58580d09a67201024e00004c \
  --header 'accept: application/json' \
  --header 'authorization: Bearer token' \

Response

Example response one order

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
HTTP 200
{
  "item": {
    "id": "5c4f1c0f95cfeba6a08a6903",
    "order_id": "ADEPRIMO-1222",
    "payment_option": "creditcard",
    "purchase_type": "recurring",
    "state": "closed",
    "subscription_start_date": "",
    "traffic_source": "web",
    "merchant_reference": "adeprimo-campaign-001",
    "child_order_ids": ["ADEPRIMO-810"],
    "parent_order_id": "ADEPRIMO-852",
    "order_detail": {
      "period_info": {
        "type": "month",
        "length": 1,
        "price": 99.0,
        "price_specification": ""
      },
      "partial_payment_info": {
        "id": null,
        "number_of_partial_payments_selected": 1
      },
      "description": "Adeprimo Plus (prenumeration, 1 månad)",
      "price": 99.0,
      "vat_code": "25",
      "created": "2019-01-28T16:13:19+01:00",
      "product_code": "adeprimo_plus"
    },
    "payments": [
      {
        "order_id": "ADEPRIMO-1222",
        "product_code": "adeprimo_plus",
        "payment_result": {
          "created": "2019-01-28T16:20:34.981+01:00",
          "order_status": "completed",
          "transaction_status": "sale",
          "transaction_number": "5c4f1dc095cfebd6fb090249",
          "payment_method": "creditcard",
          "amount": "9900",
          "error_code": null,
          "error_description": null,
          "third_party_error": null
        },
        "payment_type": "autopay",
        "payment_method": "creditcard",
        "amount": 99.0,
        "description": "Plus",
        "state": "closed",
        "provider": "Tulo",
        "price_specification": ""
      },
      {
        "order_id": "ADEPRIMO-1222",
        "product_code": "adeprimo_plus",
        "payment_result": {
          "created": "2019-01-28T16:35:23.419+01:00",
          "order_status": "completed",
          "transaction_status": "sale",
          "transaction_number": "5c4f213995cfebeae2d4fc91",
          "payment_method": "creditcard",
          "amount": "9900",
          "error_code": null,
          "error_description": null,
          "third_party_error": null
        },
        "payment_type": "autopay",
        "payment_method": "creditcard",
        "amount": 99.0,
        "description": "Plus",
        "state": "closed",
        "provider": "Tulo",
        "price_specification": ""
      }
    ]
  }
}

Example response multiple orders

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
HTTP 200
{
  "items": [{
      "id": "56cc6807400e06bc39000001",
      "order_id": "ADEPRIMO-516",
      "payment_option": "creditcard",
      "purchase_type": "recurring",
      "state": "closed",
      "subscription_start_date": "",
      "traffic_source": null,
      "child_order_ids": [],
      "parent_order_id": null,
      "order_detail": {
        "period_info": {
          "type": "month",
          "length": 1,
          "price": "149.0",
          "price_specification": ""
        },
        "partial_payment_info": null,
        "description": "Adeprimo Digital (prenumeration, 1 månad)",
        "price": 149.0,
        "vat_code": "25",
        "created": "2016-02-23T15:09:11+01:00",
        "product_code": "adeprimo_digital"
      },
      "payments": [{
          "order_id": "ADEPRIMO-516",
          "product_code": "adeprimo_digital",
          "payment_result": {
            "created": "2017-08-22T16:10:14.736+02:00",
            "order_status": "",
            "transaction_status": "0",
            "transaction_number": "15572993",
            "payment_method": "MC",
            "amount": "",
            "error_code": "",
            "error_description": "",
            "third_party_error": ""
          },
          "payment_type": "autopay",
          "payment_method": "CREDITCARD",
          "amount": 149.0,
          "description": "Adeprimo Digital",
          "state": "closed",
          "provider": "PayexCreditCardPaymentProvider",
          "price_specification": ""
        },
      ]
    },
    {
      "id": "58b92dc7400e066d2300002a",
      "order_id": "ADEPRIMO-852",
      "payment_option": "klarna",
      "purchase_type": "recurring",
      "state": "closed",
      "subscription_start_date": "",
      "traffic_source": null,
      "child_order_ids": [
        "ADEPRIMO-1222"
      ],
      "parent_order_id": null,
      "order_detail": {
        "period_info": {
          "type": "month",
          "length": 1,
          "price": "10.0",
          "price_specification": ""
        },
        "partial_payment_info": null,
        "description": "Adeprimo Digital 24 h (prenumeration, 1 månad)",
        "price": 10.0,
        "vat_code": "25",
        "created": "2017-03-03T09:48:07+01:00",
        "product_code": "adeprimo_digital_24h"
      },
      "payments": [{
          "order_id": "ADEPRIMO-852",
          "product_code": "adeprimo_digital_24h",
          "payment_result": {
            "created": "2017-09-03T10:45:15.826+02:00",
            "order_status": "completed",
            "transaction_status": "sale",
            "transaction_number": "59abc119cf31fc595b000000",
            "payment_method": "klarna",
            "amount": "1000",
            "error_code": null,
            "error_description": null,
            "third_party_error": null
          },
          "payment_type": "autopay",
          "payment_method": "KLARNA",
          "amount": 10.0,
          "description": "Adeprimo Digital 24 h",
          "state": "closed",
          "provider": "KlarnaPaymentProvider",
          "price_specification": ""
        }
      ]
    }
  ]
}

Errors

Example error response

1
2
3
4
5
6
HTTP 400 Bad Request
{
    "code": "invalid_parameter",
    "field": "account_id",
    "message": "Parameter must match format (/^[a-f\d]{24}$/)"
}

HTTP 400 Bad Request

Name Type Description
invalid_parameter Object Validation error on any of the fields in the posted json
json_parser_error Object The request body could not be parsed as valid json
invalid_content_type_error Object The requests Content-Type header isn't set to application/json
unknown_parameter Object One or more of the fields in the posted json was not recognized

HTTP 404 Not Found

Name Type Description
not_found Object The package could not be found

HTTP 500 Internal Server Error

Name Type Description
internal_server_error Object Something unexpected happened server side