Load payment link | Qliro devportal

For developers

By Qliro

Select search filters:

Load payment link

Overview

Qliro's Payment Link enables you to become more flexible in how to load Qliro Checkout. A pre-populated checkout can be redirected to in scenarios such as:

In store, loaded from the merchants point-of-sales terminal
As part of the standard flow in Qliro's Shopify integration
When the merchant wants to use Qliro's Pay Later options together with Pay Now options from another payment provider.

Get PaymentLink URL

You can choose between letting your customers choose payment option on our end within the Payment Link, or your own page. Our Payment Options API will let you know which of the payment options you have configured with Qliro that is eligible and can be displayed for the customer.

The PaymentLink URL returned from the Create Order request can be redirected to.

How-to

Generate your authentication token.
Make a POST request towards checkout/merchantapi/orders.
Retrieve the OrderID from the response.

Preselect payment methods

The PaymentId property decides which payment methods are visible in the checkout, and the eligible values for it are accessible through the Payment Options API. There are three categories of PaymentId values

A single payment option, such as "CREDITCARDS"
A group of payment options, such as "PAY_LATER"
If the property is not given a value, all of the configured payment methods will be available.

Example of a full request using Payment Link

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
{ 
MerchantApiKey: 'MerchantApiKey',
MerchantReference: 'MerchantUniqueReference',
Currency: 'SEK',
Country: 'SE',
Language: 'EN-US',
MerchantTermsUrl: 'https://merchant.com/terms/',
MerchantIntegrityPolicyUrl: 'https://merchant.com/policy/',
MerchantConfirmationUrl: 'https://merchant.com/confirmation/',
MerchantOrderValidationUrl: 'https://merchant.com/orderValidation/',
MerchantOrderManagementStatusPushUrl: 'https://ordermanagement.merchant.com/checkoutstatus',
MerchantNotificationUrl: 'https://ordermanagement.merchant.com/checkoutstatus',
MerchantCheckoutStatusPushUrl: 'https://ordermanagement.merchant.com/checkoutstatus',
OrderItems: [ 
{
MerchantReference: 'GreyHat',
DisplayName: 'Grey hat',s
Description: 'Perfect for rainy days!',
Quantity: 9,
PricePerItemIncVat: '99.00',
PricePerItemExVat: '69.30',
Type: 'Product'
}
],
ShippingAdditionalHeader: 'Lorem ipsum dolor sit amet,
consectetuer adipiscing elit.',
RequireIdentityVerification: false,
PaymentId: 'CREDITCARDS',
MerchantCancelUrl: 'url',
ButtonCornerRadius: Undefined,
CornerRadius: undefined,
CustomerInformation: {
Email: 'email@email.email',
PersonalNumber: '111111-1111',
JuridicalType: 'Physical',
MobileNumber: 46101010101,
Address: {
firstName: 'Firstname',
lastName: 'Lastname',
companyName: 'CompanyName',
street: 'Street 123',
postalCode: '12345',
city: 'Stockholm',
careOf: 'CareOf' 
},
LockCustomerInformation: true
}
}

Payment Link response

1
2
3
4
{
OrderId: 120006,
PaymentLink: 'URL/?session=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJNZXJjaGFudElkIjoiOSIsIk9yZGV'
}

Payment options API

The Payment Options API returns the configured payment options that can be used pre-selected when creating the order. The options returned are determined by:

The total order value
Country
Currency
Whether or not the order contains age-restricted items

Example Request:

1
2
3
4
5
6
7
8
9
{ 
MerchantApiKey: 'MerchantApiKey', 
MerchantReference: 'MerchantUniqueReference', 
Currency: 'SEK', 
Country: 'SE', 
Language: 'EN-US', 
TotalPrice: 891, 
HasRiskItems: false 
}

Example Response

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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
[
  {
    "PaymentId": "PAY_NOW",
    "PaymentOptionText": "Pay now",
    "Options": [
      {
        "PaymentId": "CREDITCARDS",
        "PaymentOptionText": "Pay by card",
        "Logos": {
          "Color": [
            "URL/MC.png",
            "URL/Visa.png",
            "URL/Amex.png"
          ],
          "Black": [
            "URL/MC.png",
            "URL/Visa.png",
            "URL/Amex.png"
          ],
          "White": [
            "URL/MC.png",
            "URL/Visa.png",
            "URL.png"
          ]
        },
        "Brands": [
          "MASTERCARD",
          "VISA",
          "AMEX"
        ]
      },
      {
        "PaymentId": "TRUSTLY_DIRECT",
        "PaymentOptionText": "Directly from your bank",
        "Logos": {
          "Color": [
            "URL/Trustly.png"
          ],
          "Black": [
            "URL/Trustly.png"
          ],
          "White": [
            "URL/Trustly.png"
          ]
        }
      }
    ],
    "Logos": {
      "Color": [
        "URL/Qliro_Logotype.png"
      ],
      "Black": [
        "URL/Qliro_Logotype.png"
      ],
      "White": [
        "URL/Qliro_Logotype.png"
      ]
    }
  },
  {
    "PaymentId": "PAY_LATER",
    "PaymentOptionText": "Pay later",
    "Options": [
      {
        "PaymentId": "QLIRO_INVOICE",
        "PaymentOptionText": "Within 14 days, Qliro Invoice",
        "Logos": {
          "Color": [
            "URL/Qliro_Logotype.png"
          ],
          "Black": [
            "URL/Qliro_Logotype.png"
          ],
          "White": [
            "URL/Qliro_Logotype.png"
          ]
        }
      },
      {
        "PaymentId": "QLIRO_CAMPAIGN",
        "PaymentOptionText": "Buy now, pay in March 39 sek, Qliro campaign",
        "Logos": {
          "Color": [
            "URL/Qliro_Logotype.png"
          ],
          "Black": [
            "URL/Qliro_Logotype.png"
          ],
          "White": [
            "URL/Qliro_Logotype.png"
          ]
        }
      },
      {
        "PaymentId": "QLIRO_PARTPAYMENT",
        "PaymentOptionText": "Bit by bit",
        "Logos": {
          "Color": [
            "URL/Qliro_Logotype.png"
          ],
          "Black": [
            "URL/Qliro_Logotype.png"
          ],
          "White": [
            "URL/Qliro_Logotype.png"
          ]
        }
      }
    ],
    "Logos": {
      "Color": [
        "URL/Qliro_Logotype.png"
      ],
      "Black": [
        "URL/Qliro_Logotype.png"
      ],
      "White": [
        "URL/Qliro_Logotype.png"
      ]
    }
  }
]