Paytrail Connect API allows merchants to integrate Paytrail account information and charging without redirecting to a payment selection page. It provides one-click payment with Paytrail accounts alongside existing payment methods. Transactions are charged with a 10 day settlement period and same rates as credit card payments. The document outlines the API authentication process and calls to request authorizations, confirm payments, charge payments, retrieve delivery addresses, and delete authorizations. More documentation is available on Paytrail's developer website.

1. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
Kuinka integroida
Paytrail Connect API
Webinaari 19.6.2013
Kaisa Kiviluoto
Thursday, June 20, 13

2. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
Mikä se on?
‣ Paytrail Connect API:a käytetään Paytrail-tilin
tietojen hyödyntämiseen ja veloittamiseen ilman,
että siirrytään maksutavan valintasivulle
‣ Paytrail-tili: Maksamista yhdellä klikkauksella.
‣ Paytrail Connect API tulee tutun maksupalvelun
rinnalle, ei korvaamaan sitä.
‣ Tilitysviive 10 pankkipäivää, transaktiohinnat samat
kuin luottokorttimaksuissa.
Thursday, June 20, 13

3. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
Thursday, June 20, 13

4. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
REST Authentication
(tunnistautuminen)
Shared secret in this example: "6pKF4jkv97zmqBJ3ZL8gUw5DfT2NMQ"
s
base64_encode( hash_hmac(
"SHA256",
"POST" . "n" .
"/authorizations" . "n" .
"PaytrailConnectAPI 13466" . "n" . // apikey is merchant id
"2012-12-31T12:00:00+0200" . "n" . // date('c')
"ubewX5M7uzz64zskr7FThQ==", // base64_encode(hash('md5',
http_get_request_body(), true))
"6pKF4jkv97zmqBJ3ZL8gUw5DfT2NMQ", // Merchant secret
true //Binary output
));
Thursday, June 20, 13

5. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
Mandatory headers
POST /authorizations HTTP/1.1
Timestamp: 2012-12-31T12:00:00+0200
Content-MD5: ubewX5M7uzz64zskr7FThQ==
Authorization: PaytrailConnectAPI
13466:NDMzNDA2OTA4NWVmYTRiMDUyMWI4OGNkNjkxNzBhYjBmNDE0ZjNiMmMwODkwY2ZiYjJlNTU4NGI1
NmUyMjM4ZQ==
Thursday, June 20, 13

6. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
POST /authorizations
(Pyydetään lupa käyttää tiliä)
POST /authorizations HTTP/1.1
Timestamp: 2012-12-31T12:00:00+0200
Content-MD5: ubewX5M7uzz64zskr7FThQ==
Authorization: PaytrailConnectAPI
13466:NDMzNDA2OTA4NWVmYTRiMDUyMWI4OGNkNjkxNzBhYjBmNDE0ZjNiMmMwODkwY2ZiYjJ
lNTU4NGI1NmUyMjM4ZQ==
{
"authType": "email+smspin",
"authKey": "john.doe@address.com",
"access": ["deliveryAddress", "charge"],
"validity": "once",
"locale": "fi_FI",
"signupOkUrl": "http://www.webshop.com/ok"
"signupCancelUrl": "http://www.webshop.com/Cancel"
}
Response:
HTTP/1.1 201 Created
Location: /authorizations/AXJD28237XSDHJS18928
Thursday, June 20, 13

7. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
Confirming authorization
(Vahvistetaan lupa asiakkaan
PIN-koodilla)
POST /authorizations/AXJD28237XSDHJS18928/confirmation
HTTP/1.1
Timestamp: 2012-12-31T12:00:00+0200
Content-MD5: ubewX5M7uzz64zskr7FThQ==
Authorization: PaytrailConnectAPI 13466:/
YT5YGOUA17wK6qSeyQyrLqcGsUKflRkeWu/2q7NI2g=
{
"authSecret": "9AE2DZ"
}
Response:
HTTP/1.1 201 Created
Location: /authorizations/AXJD28237XSDHJS18928/
confirmation/FF1236757632ASDF
Thursday, June 20, 13

8. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
Charging a payment
(Veloitetaan maksu kortilta)
POST /authorizations/AXJD28237XSDHJS18928/charges HTTP/1.1
Timestamp: 2012-12-31T12:00:00+0200
Content-MD5: ubewX5M7uzz64zskr7FThQ==
Authorization: PaytrailConnectAPI
13466:NDMzNDA2OTA4NWVmYTRiMDUyMWI4OGNkNjkxNzBhYjBmNDE0ZjNiMmMwODkwY2ZiYjJlNTU4NGI1
NmUyMjM4ZQ==
{
"payment": {
"paymentAmount": 10,
"currency": "EUR",
"orderNumber": "ORD12345",
"urlSet": {
"successUrl": "https://www.examplewebshop.com/success",
"cancelUrl": "https://www.examplewebshop.com/cancel",
"notifyUrl": "https://www.examplewebshop.com/notify"
},
"locale": "en_US"
}
}
Thursday, June 20, 13

9. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
Delivery address
(Pyydetään osoitetiedot)
GET /authorizations/{id}/deliveryAddresses HTTP/1.1
Timestamp: 2012-12-31T12:00:00+0200
Content-MD5: ubewX5M7uzz64zskr7FThQ==
Authorization: PaytrailConnectAPI
13466:NDMzNDA2OTA4NWVmYTRiMDUyMWI4OGNkNjkxNzBhYjBmNDE0ZjNiMmMwODkwY2ZiYjJlNTU4NGI1NmUyM
jM4ZQ==
Response:
HTTP/1.1 200 OK
{
"deliveryAddresses": [
{
"firstName": "John",
"lastName": "Doe",
"street": "Downing Street 10",
"postalCode": "40100",
"postalOffice": "Helsinki",
"country": "FI"
}
]
}
Thursday, June 20, 13

10. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
Deleting an authorization
(Poistetaan luotu lupa)
DELETE /authorizations/AXJD28237XSDHJS18928 HTTP/1.1
Timestamp: 2012-12-31T12:00:00+0200
Content-MD5: ubewX5M7uzz64zskr7FThQ==
Authorization: PaytrailConnectAPI
13466:NDMzNDA2OTA4NWVmYTRiMDUyMWI4OGNkNjkxNzBhYjBmNDE0ZjNiMmMwODkwY2ZiYjJlNTU4
NGI1NmUyMjM4ZQ==
Thursday, June 20, 13

11. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
Dokumentaatio
‣ Tarkempi rajapintakuvaus:
‣ docs.paytrail.com
Thursday, June 20, 13

12. Paytrail
Innova 2 Lutakonaukio 7 | 40100 Jyväskylä | Finland | +358 207 181 824 | info@paytrail.com | www.paytrail.com
Kiitos!
Thursday, June 20, 13