Create Transaction
POST/v1/transactions
Mandatory fields are amount
, currency
and ip
.
Request
- application/json
Body
transaction
object
required
The transaction amount
The currency code for the transaction
The unique reference for the transaction
Additional merchant data related to the transaction
Specifies if recurring payments are required
transaction_url
object
return_url
object
URL and method to return after successful payment
The URL to return to
The HTTP method (e.g., GET, POST) for the return link
cancel_url
object
URL and method for canceled payment
The URL to return to
The HTTP method (e.g., GET, POST) for the return link
notification_url
object
URL and method for payment notifications
The URL to return to
The HTTP method (e.g., GET, POST) for the return link
customer
object
required
Customer's email address
Customer's IP address
Customer's country code - Default will be chosen if not provided
Preferred language/locale of the customer - Default will be chosen if not provided
app_info
object
Name of the module/application used
Version of the module/application
Platform name, that the request is sent from. (Up to 64 characters) Required only if app_info is used in the request
Version of the platform the module runs on
Responses
- 201
- 400
- 401
Created
Response Headers
Date
string
Content-Type
string
Transfer-Encoding
string
Connection
string
Set-Cookie
string
Access-Control-Allow-Origin
string
Access-Control-Allow-Methods
string
Access-Control-Allow-Headers
string
X-Request-ID
string
Location
string
- application/hal+json
- Schema
- Example (from schema)
- Example
Schema
Array [
]
Array [
]
Array [
]
Array [
]
_links
object
Pay
object
self
object
payment_methods
object
Possible payment methods for the transaction.
** Optional field, displayed only when transaction refunded **
banklinks
object[]
Array of banklink payment methods
The name of the payment method
URL related to the payment method
Single country associated with the payment method
List of countries associated with the payment method - EE, LV, LT or FI
The minimum amount value
The maximum amount value
Channel information
Display name for the payment method
URL of the payment method's logo
cards
object[]
Array of card payment methods
The name of the payment method
URL related to the payment method
Single country associated with the payment method
List of countries associated with the payment method - EE, LV, LT or FI
The minimum amount value
The maximum amount value
Channel information
Display name for the payment method
URL of the payment method's logo
payLater
object[]
Array of pay Later methods
The name of the payment method
URL related to the payment method
Single country associated with the payment method
List of countries associated with the payment method - EE, LV, LT or FI
The minimum amount value
The maximum amount value
Channel information
Display name for the payment method
URL of the payment method's logo
other
object[]
Array of other methods
The name of the payment method
URL related to the payment method
Single country associated with the payment method
List of countries associated with the payment method - EE, LV, LT or FI
The minimum amount value
The maximum amount value
Channel information
Display name for the payment method
URL of the payment method's logo
Unique identifier for the transaction
Type of the transaction object
Timestamp when the transaction was created
Timestamp when the transaction was completed. Optional field, displayed only when transaction is completed
Timestamp when the transaction was refunded. Optional field, displayed only when transaction is refunded
Current status of the transaction
Merchant's reference number for the transaction
customer
object
The customer information related to this transaction
The unique identifier for the customer
The type of object (e.g., customer)
The timestamp when the customer was created
The email address of the customer
The locale of the customer, representing language and region
The country of the customer
The IP address of the customer
The country associated with the customer's IP address
The name of the customer
Amount refunded for this transaction. Optional field, displayed only when transaction is refunded
Original amount refunded. Optional field, displayed only when transaction is refunded
Type of transaction. Shows payment type - banklink or card
Payment method used in the transaction
Payment channel through which the transaction was made
Country where the transaction was made
Transaction fees. Optional field, displayed only when transaction is completed
VAT on transaction fees. Optional field, displayed only when transaction is completed
Net amount received by the merchant. Optional field, displayed only when transaction is completed
Additional merchant-specific data
banklink
object
Details of banklink payment. Optional field, displayed only when transaction type is banklink
The type of object, e.g., 'banklink_payment'.
The date and time when the payment was created, in ISO 8601 format.
The International Bank Account Number associated with the payment.
A description of the payment.
card
object
Details of Card payment. Optional field, displayed only when transaction type is card
Name of the cardholder
Masked card number used in the payment
Expiry date of the card
Type of card (e.g., Visa, MasterCard)
transaction_url
object
return_url
object
The URL and HTTP method to redirect after a successful operation
The URL to return to
The HTTP method (e.g., GET, POST) for the return link
cancel_url
object
The URL and HTTP method to redirect when the operation is canceled
The URL to return to
The HTTP method (e.g., GET, POST) for the return link
notification_url
object
The URL and HTTP method for notifications regarding the operation
The URL to return to
The HTTP method (e.g., GET, POST) for the return link
cart_url
object
The URL and HTTP method to access the shopping cart
The URL to return to
The HTTP method (e.g., GET, POST) for the return link
Indicates if recurring payments are required
{
"_links": {
"Pay": {
"href": "string"
},
"self": {
"href": "string"
}
},
"payment_methods": {
"banklinks": [
{
"name": "string",
"url": "string",
"country": "string",
"countries": [
"string"
],
"min_amount": 0,
"max_amount": 0,
"channel": "string",
"display_name": "string",
"logo_url": "string"
}
],
"cards": [
{
"name": "string",
"url": "string",
"country": "string",
"countries": [
"string"
],
"min_amount": 0,
"max_amount": 0,
"channel": "string",
"display_name": "string",
"logo_url": "string"
}
],
"payLater": [
{
"name": "string",
"url": "string",
"country": "string",
"countries": [
"string"
],
"min_amount": 0,
"max_amount": 0,
"channel": "string",
"display_name": "string",
"logo_url": "string"
}
],
"other": [
{
"name": "string",
"url": "string",
"country": "string",
"countries": [
"string"
],
"min_amount": 0,
"max_amount": 0,
"channel": "string",
"display_name": "string",
"logo_url": "string"
}
]
},
"id": "string",
"object": "string",
"created_at": "2024-07-29T15:51:28.071Z",
"completed_at": "2024-07-29T15:51:28.071Z",
"refunded_at": "2024-07-29T15:51:28.071Z",
"status": "string",
"reference": "string",
"customer": {
"id": "string",
"object": "string",
"created_at": "2024-07-29T15:51:28.071Z",
"email": "string",
"locale": "string",
"country": "string",
"ip": "string",
"ip_country": "string",
"name": "string"
},
"refunded_amount": 0,
"refunded_original_amount": 0,
"type": "string",
"method": "string",
"channel": "string",
"country": "string",
"fees": 0,
"fees_vat": 0,
"net_amount": 0,
"merchant_data": "string",
"banklink": {
"object": "string",
"created_at": "2024-07-29T15:51:28.071Z",
"iban": "string",
"description": "string"
},
"card": {
"card_holder_name": "string",
"card_number": "string",
"expiry_date": "string",
"card_type": "string"
},
"transaction_url": {
"return_url": {
"url": "string",
"method": "string"
},
"cancel_url": {
"url": "string",
"method": "string"
},
"notification_url": {
"url": "string",
"method": "string"
},
"cart_url": {
"url": "string",
"method": "string"
}
},
"recurring_required": true
}
{
"_links": {
"Pay": {
"href": "https://api.test.maksekeskus.ee/v1/transactions/1fea72b7-cc54-4844-8409-5ff188eb40c3/payments"
},
"self": {
"href": "https://api.test.maksekeskus.ee/v1/transactions/1fea72b7-cc54-4844-8409-5ff188eb40c3"
}
},
"amount": 75.95,
"channel": null,
"country": "ee",
"created_at": "2024-01-06T12:04:14+0000",
"currency": "EUR",
"customer": {
"country": "ee",
"created_at": "2024-01-06T12:04:14+0000",
"email": "mk.test@maksekeskus.ee",
"id": "d4c7bcc8-c962-49d9-b18b-a9c79fdbd8cc",
"ip": "10.128.96.76",
"locale": "en",
"name": "d4c7bcc8-c962-49d9-b18b-a9c79fdbd8cc",
"object": "customer"
},
"id": "1fea72b7-cc54-4844-8409-5ff188eb40c3",
"merchant_data": "Internal Order ID: 321",
"method": null,
"object": "transaction",
"payment_methods": {
"banklinks": [
{
"channel": "Swedbank EE OB",
"countries": [
"ee"
],
"country": "ee",
"display_name": "Swedbank",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/swedbank.png",
"max_amount": 15000,
"name": "swedbank",
"url": "https://payment.test.maksekeskus.ee/open-banking.html?method=EE_SWED_OB&trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
},
{
"channel": "SEB EE OB",
"countries": [
"ee"
],
"country": "ee",
"display_name": "SEB",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/seb.png",
"max_amount": 15000,
"name": "seb",
"url": "https://payment.test.maksekeskus.ee/open-banking.html?method=EE_SEB_OB&trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
},
{
"channel": "LHV EE OB",
"countries": [
"ee"
],
"country": "ee",
"display_name": "LHV",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/lhv.png",
"max_amount": 15000,
"name": "lhv",
"url": "https://payment.test.maksekeskus.ee/open-banking.html?method=EE_LHV_OB&trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
},
{
"channel": "Luminor EE",
"countries": [
"ee"
],
"country": "ee",
"display_name": "Luminor",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/luminor.png",
"max_amount": 100000,
"name": "nordea",
"url": "https://payment.test.maksekeskus.ee/banklink.html?method=EE_NORDEA&trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
},
{
"channel": "Coop Pank EE",
"countries": [
"ee"
],
"country": "ee",
"display_name": "Coop Pank",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/coop.png",
"max_amount": 100000,
"name": "krediidipank",
"url": "https://payment.test.maksekeskus.ee/banklink.html?method=EE_KREDIIDI&trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
},
{
"channel": "Pocopay EE",
"countries": [
"ee",
"fi"
],
"country": "ee",
"display_name": "Pocopay",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/pocopay.png",
"max_amount": 100000,
"name": "pocopay",
"url": "https://payment.test.maksekeskus.ee/banklink.html?method=EE_POCOPAY&trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
},
{
"channel": "Revolut PIS",
"countries": [
"ee"
],
"country": "ee",
"display_name": "Revolut",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/revolut.png",
"max_amount": 15000,
"name": "revolut",
"url": "https://payment.test.maksekeskus.ee/open-banking.html?method=REVOLUT_PIS&trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
}
],
"cards": [
{
"channel": "Visa",
"display_name": "Visa",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/visa.png",
"max_amount": 1000,
"name": "visa",
"url": "https://payment.test.maksekeskus.ee/card.html?trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
},
{
"channel": "MasterCard",
"display_name": "MasterCard",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/mastercard.png",
"max_amount": 1000,
"name": "mastercard",
"url": "https://payment.test.maksekeskus.ee/card.html?trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
}
],
"other": [
{
"name": "redirect",
"url": "https://payment.test.maksekeskus.ee/pay.html?trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
}
],
"payLater": [
{
"channel": "Inbank jaga osadeks",
"countries": [
"ee"
],
"country": "ee",
"display_name": "Inbank jaga osadeks",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/slice.png",
"max_amount": 2500,
"min_amount": 75,
"name": "slice",
"url": "https://payment.test.maksekeskus.ee/pay-later.html?method=EE_SLICE&trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
},
{
"channel": "Liisi ID EE",
"countries": [
"ee"
],
"country": "ee",
"display_name": "Liisi ID",
"logo_url": "https://static.test.maksekeskus.ee/img/channel/lnd/liisi_ee.png",
"max_amount": 10000,
"min_amount": 30,
"name": "liisi_ee",
"url": "https://payment.test.maksekeskus.ee/pay-later.html?method=EE_LIISI_EE&trx=1fea72b7-cc54-4844-8409-5ff188eb40c3"
}
]
},
"recurring_required": false,
"reference": "123abc",
"status": "CREATED",
"transaction_url": {
"cancel_url": {
"method": "POST",
"url": "https://example.com/cancel_url"
},
"cart_url": null,
"notification_url": {
"method": "POST",
"url": "https://example.com/notification_url"
},
"return_url": {
"method": "POST",
"url": "https://example.com/return_url"
}
},
"type": null
}
Bad Request
Response Headers
Date
string
Content-Type
string
Transfer-Encoding
string
Connection
string
Set-Cookie
string
Access-Control-Allow-Origin
string
Access-Control-Allow-Methods
string
Access-Control-Allow-Headers
string
X-Request-ID
string
- application/json
- Schema
- Example (from schema)
- Example
Schema
Array [
]
Error code indicating the type of error
Error message describing the issue
errors
object[]
Type of error
Parameter in the request that caused the error
The expected value or format for the parameter
{
"code": 1001,
"message": "Invalid request",
"errors": [
{
"type": "string",
"parameter": "transaction",
"expected": "string"
}
]
}
{
"code": 1001,
"message": "Invalid request",
"errors": [
{
"type": "invalid",
"resource": "transaction",
"field": "amount",
"expected": "positive values"
}
]
}
Unauthorized
Response Headers
Date
string
Content-Type
string
Transfer-Encoding
string
Connection
string
Set-Cookie
string
WWW-Authenticate
string
- application/json
- Schema
- Example (from schema)
- Example
Schema
Error code representing the type of error.
Detailed error message.
{
"code": 0,
"message": "string"
}
{
"code": 1004,
"message": "Unauthorized"
}