Skip to content

Get product

/products

Target audience: Developers

1
Release version: 4.3.5

Get product

Introduction

Returns a single campaign/package/product for an organisation

URI

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

Requirements

Identity Scope
No /external/product/r

Parameters

Name Type Description
id String Id of a product. Cannot be used together with product_code.
Size range: ..24 Allowed values: "/^[a-f\d]{24}$/i"
product_code String The product code for a product/package/campaign. Cannot be used together with id.
Size range: 1..50 Allowed values: "/^[a-zA-Z-_0-9]+$/"

Curl Example

Get by id

1
2
3
4
curl --request GET \
  --url https://payway-api.stage.adeprimo.se/external/api/v2/products?product_id=52a781d6400e06897c00000f \
  --header 'accept: application/json' \
  --header 'authorization: Bearer token' \

Get by product_code

1
2
3
4
curl --request GET \
  --url https://payway-api.stage.adeprimo.se/external/api/v2/products?product_code=adeprimo_digital \
  --header 'accept: application/json' \
  --header 'authorization: Bearer token' \

Response

Successful response campaign that will transform into package

1
HTTP 200
 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
{
  "item": {
    "id": "60253f1809c04c24149cba44",
    "valid_from": "2020-02-12T15:28:40+01:00",
    "valid_to": "2020-02-12T15:28:40+01:00",
    "product_code": "trial",
    "integration_code": "campaign_integration_code",
    "title_code": "TITLE_CODE",
    "name": "Adeprimo summer campaign",
    "description": "Please buy our nice summer campaign, it is very nice and gives you news.",
    "additional_short_description": null,    
    "transform_to_campaign_package": true,
    "customer_can_cancel": false,
    "vat_code": 25,
    "tags": [
      {
        "name": "campaign_tag",
        "type": "package"
      }
    ],
    "price_periods": [
      {
        "id": "60253f1809c04c24149cba47",
        "payment_method": "adyen",
        "type": "recurring",
        "enabled": true,
        "iteration_type": "month",
        "iteration_length": 1,
        "price": 210,
        "details": {
          "type": "scheme",
          "name": "Card"
        },
        "transition_price_period_id": "60253f1809c04c24149cba3f"
      }
    ],
    "transition_to": {
      "package_code": "package_code",
      "customer_can_cancel": false,
      "products": [
        {
          "id": "60253f1809c04c24149cba3a",
          "product_code": "product_code",
          "name": "product_name",
          "description": "short_description"
        }
      ],
      "tags": [],
      "price_periods": [
        {
          "id": "60253f1809c04c24149cba3f",
          "payment_method": "adyen",
          "type": "recurring",
          "enabled": true,
          "iteration_type": "month",
          "iteration_length": 1,
          "price": 210,
          "details": {
            "type": "scheme",
            "name": "Card"
          }
        }
      ],
      "vat_code": 25,
      "id": "60253f1809c04c24149cba3d",
      "valid_from": "2020-02-12T15:28:40+01:00",
      "valid_to": "2020-02-12T15:28:40+01:00",
      "integration_code": "package_integration_code",
      "title_code": "TITLE_CODE",
      "name": "Adeprimo summer package",
      "description": "Please buy our nice summer package, it is very nice and gives you news.",
      "additional_short_description": "Nice summer package"
    }
  }
}

Successful response campaign that will NOT transform to package

1
HTTP 200
 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
{
  "item": {
    "id": "6025401c09c04c25c53c386c",
    "valid_from": "2020-02-12T15:33:00+01:00",
    "valid_to": "2020-02-12T15:33:00+01:00",
    "product_code": "campaign_code",
    "integration_code": "campaign_integration_code",
    "title_code": "TITLE_CODE",
    "name": "Adeprimo summer campaign",
    "description": "Please buy our nice summer campaign, it is very nice and gives you news.",
    "additional_short_description": null,    
    "transform_to_campaign_package": false,
    "customer_can_cancel": false,
    "vat_code": 25,
    "tags": [
      {
        "name": "campaign_tag",
        "type": "package"
      }
    ],
    "price_periods": [
      {
        "id": "6025401c09c04c25c53c386f",
        "payment_method": "adyen",
        "type": "recurring",
        "enabled": true,
        "iteration_type": "month",
        "iteration_length": 3,
        "price": 210,
        "details": {
          "type": "scheme",
          "name": "Card"
        }
      }
    ]
  }
}

Successful response package

1
HTTP 200
 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
{
  "item": {
    "product_code": "package_code",
    "customer_can_cancel": false,
    "products": [
      {
        "id": "6025405109c04c2660320bb6",
        "product_code": "product_code",
        "name": "product_name",
        "description": "short_description"
      }
    ],
    "tags": [],
    "price_periods": [
      {
        "id": "6025405109c04c2660320bbb",
        "payment_method": "adyen",
        "type": "recurring",
        "enabled": true,
        "iteration_type": "month",
        "iteration_length": 1,
        "price": 210,
        "details": {
          "type": "scheme",
          "name": "Card"
        }
      }
    ],
    "vat_code": 25,
    "id": "6025405109c04c2660320bb9",
    "valid_from": "2020-02-12T15:33:53+01:00",
    "valid_to": "2020-02-12T15:33:53+01:00",
    "integration_code": "package_integration_code",
    "title_code": "TITLE_CODE",
    "name": "Adeprimo summer package",
    "description": "Please buy our nice summer package, it is very nice and gives you news.",
    "additional_short_description": "Nice summer package"
  }
}

Successful response product

1
HTTP 200
1
2
3
4
5
6
7
8
{
  "item": {
    "id": "6025408e09c04c2706627430",
    "product_code": "product_code",
    "name": "product_name",
    "description": "short_description"
  }
}

Errors

This API uses the common error conventions of the Payway API

See common error responses