Paysera - API dokumentacija

Informacija Atsiprašome, šis skyrius galimas tik anglų kalba.

Transaction groups one or more objects into one confirmable group. To confirm any created object, there must be a transaction.

Informacija Default transaction is created together with payment and allowance to be confirmed without creating it manually.

Moreover, transactions take part in all-or-nothing scenarios: either all of grouped payments are done successfully, or all fail. For example, if wallet has sufficient account balance only for one of grouped payments, user will be unable to confirm this transaction.
Transactions are also good when making shop carts with payments to different beneficiaries - user will have to confirm something just once.

Įspėjimas Transactions group payments only when confirming. If payment is canceled, other payments in the same transaction remain unchanged.

Automatically created transactions

When creating payment or allowance, transaction is created with default parameters. It's key is provided in the response as transaction_key. Automatically created transaction always has only one payment or allowance.
allowance parameter optional is false in automatically created transactions.
transaction_key for payment or allowance can change if new transaction is created with that payment or allowance. Only one transaction can be assigned to any payment or allowance - if payment is added to another transaction, it is removed from the old one.

Create transaction

This method creates transaction that groups payment(s) and/or allowance into one confirmable item.

Įspėjimas Transactions with status new are deleted automatically 1 month after creation time.

Request

POST https://wallet.paysera.com/rest/v1/transaction

Request body structure

Parametras

Tipas

Pastabos

Aprašymas

payments

array of mixed

required if allowance is not specified

Array of payment IDs or payment structures to be grouped into this transaction. If IDs are provided, transaction is created from already existing payments. If structures (objects) are provided, payment is automatically created before assigning it to transaction. Payment structure is the same as when creating payment. IDs and structures can be mixed together into one array

allowance

object (see Allowance data structure)

required if payments is not specified

Allowance to be grouped with payments into this transaction

reserve

object

optional
It's used with one of parameter inside: for or until
unavailable if reserve_until or reserve_for is provided

It is used with one of additional parameters inside:
for - Maximum reservation time in seconds. Time starts when user accepts transaction. In this time must confirm the transaction to finish it successfuly, otherwise money will be returned to the payer
until - Maximum reservation time in UNIX timestamp - reservation will last up to that moment

reserve_for

integer

optional, defaults to 24 hours
unavailable if reserve_until or reserve is provided

Deprecated. Use parameter reserve with subparameter for instead.
Maximum reservation time in hours. Time starts when user accepts transaction. In this time you must confirm the transaction to finish it successfuly, otherwise money will be returned to the payer

reserve_until

integer

optional, unavailable if reserve_for or reserve is provided

Deprecated. Use parameter reserve with subparameter until instead.
Maximum reservation time in UNIX timestamp - reservation will last up to that moment

use_allowance

boolean

optional, defaults to false

Whether active allowance should be automatically used when requesting affirmation from user. This parameter is ignored and true is used if accepting transaction by using active allowance

suggest_allowance

boolean

optional, defaults to false;
ignored if allowance is provided

Whether Paysera system should suggest user to make allowance if user is redirected to payment confirmation page. Limits and other allowance information is calculated by Paysera system. This type of allowance is always optional for user

auto_confirm

boolean

optional, defaults to false;
unavailable if at least one payment in transaction has no beneficiary specified

If set to true, transaction is automatically confirmed after going to reserved. This option is only available if transaction has only allowance or only payments with beneficiary specified. This option is unrecommended, use it only if confirmation from the client is unavailable.

redirect_uri

string

optional

Provides URI to redirect user after confirming transaction. This parameter is ignored if confirmation is made not by confirmation page.

callback_uri

string | boolean false

optional, defaults to one set in Paysera service agreement

Provides URI that callback should be done to. If false is provided, callbacks for this transaction will not be made

user

object (see User data structure)

optional

Provides confirmed user data to ease the process of registration. Your project must have special privilege for this parameter to work, otherwise it's ignored. In either case user can log-in or register with any other data, but in this case she would have to confirm it manually

inquiries

array of objects (see Inquiries)

optional

Provides a list of data, which user will be asked to provide or grant access to

Įspėjimas You can create transactions only of yet new objects. If you include already confirmed payment, operation will fail

Informacija You can provide only one allowance, because only one can be active for the wallet at any time

Allowance data structure

Parametras

Tipas

Pastabos

Aprašymas

id

integer

required if data is not provided;
unavailable if data is provided

ID of already created allowance

data

object

required if id is not provided;
unavailable if id is provided

Structure of allowance to be automatically created before assigning it to transaction. Structure is the same as when creating allowance

optional

boolean

optional, defaults to false

Whether this allowance is optional in this transaction. User will be able to uncheck optional allowance

User data structure

Parametras

Tipas

Pastabos

Aprašymas

email

string

required

Confirmed email of current user

Response data structure

On success API returns transaction object that was created. See get transaction information for more info.

Errors

limit_violation (status code 400)

Example request for grouping already created payments

POST /rest/v1/transaction HTTP/1.1
Host: wallet.paysera.com
Content-Type: application/json;charset=utf-8
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="WAkhZJYmq4avsKOxXKBjOFM7Z7HnPhC5LR7FN4e/sys=", ext="body_hash=PeBwBRvUOAkvAMBcOdXPPpg6u%2Bn1naMXUupsHZK01Rg%3D"

{
    "payments": [
        2987,
        2988
    ],
    "suggest_allowance": true
}

Example response

HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8

{
    "transaction_key": "pDAlAZ3z",
    "created_at": 1355314332,
    "status": "new",
    "project_id": 2248,
    "valid_for_payment_card_debit": false,
    "payments": [
        {
            "id": 2987,
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "new",
            "price": 1299,
            "currency": "EUR",
            "price_decimal": "12.99",
            "description": "Payment for order No. 2001",
            "parameters": {
                "orderid": 2001
            }
        },
        {
            "id": 2988,
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "new",
            "price": 500,
            "currency": "EUR",
            "price_decimal": "5.00",
            "description": "Payment for order No. 2002",
            "parameters": {
                "orderid": 2002
            }
        }
    ],
    "reserve": {
        "until": 1355400732
    },
    "use_allowance": false,
    "suggest_allowance": true,
    "auto_confirm": false
}

Informacija transaction_key of all objects in the transaction are the same and equals to that of transaction itself

Example request for creating payment and assigning optional allowance

POST /rest/v1/transaction HTTP/1.1
Host: wallet.paysera.com
Content-Type: application/json;charset=utf-8
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="R5Kw+qeaej/TRdVEkxbKzJHeHfA7HbsEcI4StcJo3lU=", ext="body_hash=gK8kVbYW1XEeZUf4BR1yZ45YLu%2BEYnq1WOGYtRhxyQA%3D"

{
    "payments": [
        {
            "description": "Payment for order No. 1234",
            "price": 1299,
            "currency": "EUR",
            "parameters": {
                "orderid": 1234
            }
        }
    ],
    "allowance": {
        "id": 784,
        "optional": true
    },
    "redirect_uri": "http://www.example.com/somePage"
}

Example response

HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8

{
    "transaction_key": "pDAlAZ3z",
    "created_at": 1355314332,
    "status": "new",
    "project_id": 2248,
    "valid_for_payment_card_debit": false,
    "payments": [
        {
            "id": 2988,
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "new",
            "price": 1299,
            "currency": "EUR",
            "price_decimal": "12.99",
            "description": "Payment for order No. 1234",
            "parameters": {
                "orderid": 1234
            }
        }
    ],
    "allowance": {
        "optional": true,
        "data": {
            "id": 784,
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "new",
            "description": "Allowance for weekly services (5 weeks)",
            "currency": "EUR",
            "max_price": 1500,
            "max_price_decimal": "15.00",
            "limits": [
                {
                    "max_price": 300,
                    "max_price_decimal": "3.00",
                    "time": 604800
                }
            ]
        }
    },
    "reserve": {
        "until": 1355400732
    },
    "use_allowance": false,
    "suggest_allowance": false,
    "auto_confirm": false,
    "redirect_uri": "http://www.example.com/somePage"
}

Renew transaction

This method creates new transaction based on some other transaction. Basically it resets transaction status to new, but new transaction is created for this purpose to be able to see all history more easily.

Transaction must have one of these status codes to be renewed: deleted, rejected, failed, revoked.

Request

POST https://wallet.paysera.com/rest/v1/transaction/renew/:transaction_key

Parameters

transaction_key: transaction_key assigned to transaction. Can be get from creation response of transaction or some other object

Response data structure

On success API returns transaction object that was created. See get transaction information for more info.

Example request

POST /rest/v1/transaction/renew/pDAlAZ3z HTTP/1.1
Host: wallet.paysera.com
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="1fOTmeSJdSPBoLGYSn4ORO7U6fvT7QcJIkJ8TXcuDAQ="

Get transaction information

This method returns transaction information that was created earlier. Transaction information can change in time, because it contains status field.

Request

GET https://wallet.paysera.com/rest/v1/transaction/:transaction_key

Parameters

transaction_key: key of transaction. Can be get from transaction and other objects creation responses

Response data structure

Parametras

Tipas

Pastabos

Aprašymas

transaction_key

string

always

Transaction key as an identifier to this transaction

created_at

integer

always

Date of transaction creation in UNIX timestamp

status

string

always

Status of transaction. One of: new, waiting, waiting_funds, waiting_registration, waiting_password, revoked, rejected, failed, reserved, confirmed, deleted

type

string

Only if status is not new

Type of transaction - the way in which confirmation of transaction was presented (or not) to the user. On of: automatic, page, flash, user_initiated, pin, reservation_code, mobile_app

wallet

integer

Only if this payment was already related with some wallet,
always if status is reserved or confirmed

Wallet ID in Paysera system, with which this transaction is related

valid_for_payment_card_debit

boolean

always

Whether transaction can be related with debit card

confirmed_at

integer

Only if status is confirmed

Date of transaction confirmation in UNIX timestamp

correlation_key

string

Only if status is waiting and type is flash

Only if confirming by the phone - some random string that was also sent to the user. You should show the same code in your page together with total price of transaction and other details, so that the user can be sure that she is confirming the right transaction

project_id

integer

Only if available

ID of the project to which this transaction is related. Usually this is ID of the project, related to the current client

payments

array of objects

Only if payments was provided when creating the transaction

Array of created payments. Structure of each payment in array is the same as when getting payment information

allowance

object

Only if allowance was provided when creating the transaction

Object with 2 keys: optional (same as when creating the transaction) and data, which holds allowance object. Structure of the object is the same as when getting allowance information

reserve

object

It's used with one of parameter inside: for or until

It is used with one of additional parameters inside:
for - same as provided when creating the transaction. Only if it was provided when creating the transaction
until - date in UNIX timestamp until when the money is reserved for this transaction. You must confirm transaction before this time to finish it. Only if status is reserved or it was provided when creating the transaction

reserve_until

integer

Only if status is reserved or it was provided when creating the transaction

Deprecated. Use parameter reserve with subparameter until instead.
Date in UNIX timestamp until when the money is reserved for this transaction. You must confirm transaction before this time to finish it

reserve_for

integer

Only if it was provided when creating the transaction

Deprecated. Use parameter reserve with subparameter for instead.
Same as provided when creating the transaction

use_allowance

boolean

Only if status is new

Same as provided when creating the transaction or true if not provided

suggest_allowance

boolean

Only if status is new

false if suggest_allowance was not provided or allowance was, otherwise the same as when creating the transaction

auto_confirm

boolean

always

Same as provided when creating the transaction

redirect_uri

string

Only if redirect_uri was provided when creating the transaction

Same as provided when creating the transaction

callback_uri

string

Only if callback_uri was provided when creating the transaction

Same as provided when creating the transaction

manager_id

integer

Only if transaction was created when using access token of a manager

User ID of manager which created the transaction (for example, logged in user in retailers app)

user

object (see User data structure)

Only if user was provided when creating the transaction

Same as provided when creating the transaction

inquiries

array of objects (see Inquiries)

Only if inquiries where provided when creating transaction

Same as provided when creating the transaction

location_id

integer

Only if available

ID of the location from which this transaction was created.

Meaning of transaction status codes

new: Initial state of the transaction. Only new transactions can be given to the user to accept.
waiting: Transaction was presented to the user and is waiting for user to accept or reject.
waiting_funds: Transaction was accepted by user on the web page, but there is not enough funds in selected account. After incoming funds, if it is enough for all payments in transaction, flow continues.
waiting_registration: Transaction was accepted by user and money was reserved, but at least one beneficiary is not yet registered in Paysera system.
This state can be entered from new, if reserve transaction API method was used with active allowance and at least one beneficiary is not yet registered.
Transaction can be in this state only when making payments between users and using phone or email identifier for beneficiary.
waiting_password: Transaction was accepted by user and money was reserved, but a password was given for at least one payment and is still not provided. Password should be provided by client or by user, receiving the payment.
This state can be entered from new, if reserve transaction API method was used with active allowance and at least one password was given.
revoked: Client can revoke transactions which are waiting, waiting_funds, waiting_registration, waiting_password or reserved. After revoking, transaction will become revoked
rejected: User has rejected this transaction
failed: Transaction has failed due to a timeout or some similar reason
reserved: Transaction has been accepted by the user and the money was reserved for this transaction. You must confirm or revoke the transaction. If no action is made in some time, transaction is automatically made failed and money reservation is canceled. You can know when transaction is reserved by using callbacks.
confirmed: You have confirmed the transaction. It is successfully made, this is the final state of the transaction
deleted: Transactions with status new are automatically deleted after some time. Deleted items are accessible in the system only by providing their unique identifier.

Informacija Blue arrows indicate state changes initiated by using API

Informacija done and canceled statuses are available only for payments. Up to these states, all payments in the same transaction has the same status as the transaction itself

Example request

GET /rest/v1/transaction/pDAlAZ3z HTTP/1.1
Host: wallet.paysera.com
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="G8FdB/Ck6eSGwDo2Em4kDG4N3pr4s72r8H1OvXhzbdE="

Informacija In this example we are requesting information about transaction which key is pDAlAZ3z

Example response

HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8

{
    "transaction_key": "pDAlAZ3z",
    "created_at": 1355314332,
    "status": "confirmed",
    "type": "page",
    "wallet": 14471,
    "valid_for_payment_card_debit": false,
    "confirmed_at": 1355314392,
    "project_id": 2248,
    "payments": [
        {
            "id": 2988,
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "confirmed",
            "price": 1299,
            "currency": "EUR",
            "price_decimal": "12.99",
            "wallet": 14471,
            "confirmed_at": 1355314392,
            "freeze": {
                "until": 1357992732
            },
            "description": "Payment for order No. 1234",
            "parameters": {
                "orderid": 1234
            }
        }
    ],
    "allowance": {
        "optional": true,
        "data": {
            "id": 784,
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "active",
            "currency": "EUR",
            "wallet": 14471,
            "confirmed_at": 1355314392,
            "valid": {
                "until": 1357992732
            },
            "description": "Allowance for weekly services (5 weeks)",
            "max_price": 1500,
            "max_price_decimal": "15.00",
            "limits": [
                {
                    "max_price": 300,
                    "max_price_decimal": "3.00",
                    "time": 604800
                }
            ]
        }
    }
}

Search transactions

This method returns transaction list by provided filters.

Request

GET https://wallet.paysera.com/rest/v1/transactions?status=:status&wallet=:wallet&from=:from&to=:to&limit=:limit&offset=:offset

Parameters

status: optional; comma separated statuses of transactions to search for
wallet: optional; ID of the wallet in Paysera system which was related to the transaction
from: optional; date from which results should be provided in UNIX timestamp. Defaults to week before to
to: optional; date from which results should be provided in UNIX timestamp. Defaults to current time
limit: optional; maximum number of results to be returned in one response. Defaults to 20, maximum available is 200
offset: optional; number of results to skip. Defaults to 0

Informacija Items are ordered from newest to oldest

Informacija Only transactions, related to the project related to specific request are returned. If client is public (like mobile applications), also filtering by the client is applied

Response data structure

Parametras

Tipas

Pastabos

Aprašymas

transactions

array of objects

always

Each item in array is transaction object

_metadata

object

always

Additional information about result

Metadata information structure

Parametras

Tipas

Pastabos

Aprašymas

total

integer

always

Total count of results, ignoring limit and offset parameters

offset

integer

always

Used offset - how many results from the beginning were skipped

limit

integer

always

Used limit - maximum count of available results in single response

Example request when searching for reserved transactions

GET /rest/v1/transactions?status=reserved%2Cconfirmed HTTP/1.1
Host: wallet.paysera.com
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="tJHijYiz23/2KvTeaRf2E2dxsuodkuukY9UNR/J08hE="

Example response

HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8

{
    "transactions": [
        {
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "reserved",
            "type": "page",
            "wallet": 14471,
            "valid_for_payment_card_debit": false,
            "project_id": 2248,
            "payments": [
                {
                    "id": 2988,
                    "transaction_key": "pDAlAZ3z",
                    "created_at": 1355314332,
                    "status": "confirmed",
                    "price": "12.99",
                    "currency": "EUR",
                    "wallet": 14471,
                    "confirmed_at": 1355314392,
                    "freeze": {
                        "until": 1357992732
                    },
                    "description": "Payment for order No. 1234",
                    "parameters": {
                        "orderid": 1234
                    }
                }
            ]
        }
    ],
    "_metadata": {
        "total": 1,
        "offset": 0,
        "limit": 50
    }
}

Revoke transaction

This method revokes transaction. status of the transaction must be waiting, waiting_funds, waiting_registration, waiting_password or reserved. If transaction is new, this method deletes it.

Request

DELETE https://wallet.paysera.com/rest/v1/transaction/:transaction_key

Parameters

transaction_key: key of transaction. Can be get from transaction and other objects creation responses

Response data structure

On success API returns transaction object that was revoked. See get transaction information for more info.

Example request

DELETE /rest/v1/payment/pDAlAZ3z HTTP/1.1
Host: wallet.paysera.com
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="zdgKunsm+SVagkNOnpMNJl4jiwSmnM7Bezy2/bYFh9Q="

Informacija In this example we are revoking transaction which key is pDAlAZ3z

Example response

HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8

{
    "transaction_key": "pDAlAZ3z",
    "created_at": 1355314332,
    "status": "revoked",
    "type": "page",
    "wallet": 14471,
    "valid_for_payment_card_debit": false,
    "project_id": 2248,
    "payments": [
        {
            "id": 2988,
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "revoked",
            "price": 1299,
            "currency": "EUR",
            "price_decimal": "12.99",
            "wallet": 14471,
            "freeze": {
                "until": 1357992732
            },
            "description": "Payment for order No. 1234",
            "parameters": {
                "orderid": 1234
            }
        }
    ],
    "allowance": {
        "optional": true,
        "data": {
            "id": 784,
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "inactive",
            "currency": "EUR",
            "wallet": 14471,
            "valid": {
                "until": 1357992732
            },
            "description": "Allowance for weekly services (5 weeks)",
            "max_price": 1500,
            "max_price_decimal": "15.00",
            "limits": [
                {
                    "max_price": 300,
                    "max_price_decimal": "3.00",
                    "time": 604800
                }
            ]
        }
    }
}

Confirm transaction

When the money is reserved, you can confirm or revoke the transaction.

Request

PUT https://wallet.paysera.com/rest/v1/transaction/:transaction_key/confirm

Parameters

transaction_key: transaction_key assigned to transaction. Can be get from creation response of transaction or some other object

Request data structure

Request body is optional and can be provided if it is needed to reduce amounts of one or several payments at confirmation time. If amount change is not needed, request body can be omitted.

If provided, request structure must be an object, which keys are payment IDs in current transaction, and each value is price object.

Structure of price object

Parametras

Tipas

Pastabos

Aprašymas

price

integer

required if price_decimal is not provided,
unavailable if price_decimal is provided

Same or reduced price of this payment in cents

currency

string

required

Currency for this payment. Must be the same as original

price_decimal

string

required if price is not provided,
unavailable if price is provided

Same or reduced decimal price of this payment

Response data structure

Confirmed transaction is returned on success. See get transaction information response data structure for more information.

Errors

If cashback is set to any of the payments, following errors may occur: not_enough_funds (status code 400), limits_exceeded (status code 400), restriction_limits_exceeded (status code 400), no_rights (status code 400)

Example request

PUT /rest/v1/transaction/pDAlAZ3z/confirm HTTP/1.1
Host: wallet.paysera.com
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="ZQYIS0L4Uq40te+qxNXJzWHNO6Ff7qhnEDuwduFlqRI="

Example request with price reduction

PUT /rest/v1/transaction/pDAlAZ3z/confirm HTTP/1.1
Host: wallet.paysera.com
Content-Type: application/json;charset=utf-8
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="Uvw+/2IIWPhmbVg9slod1EHhrxX/1dAMkCALBWVIktI=", ext="body_hash=oeolAI8pLwYDuNDCv74QhcBxRH7ec3cNt5PkaFyrVHo%3D"

{
    "2988": {
        "price": 799,
        "currency": "EUR"
    }
}

Example response

HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8

{
    "transaction_key": "pDAlAZ3z",
    "created_at": 1355314332,
    "status": "confirmed",
    "type": "page",
    "wallet": 14471,
    "valid_for_payment_card_debit": false,
    "confirmed_at": 1355314392,
    "project_id": 2248,
    "payments": [
        {
            "id": 2988,
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "confirmed",
            "price": 1299,
            "currency": "EUR",
            "price_decimal": "12.99",
            "wallet": 14471,
            "confirmed_at": 1355314392,
            "freeze": {
                "until": 1357992732
            },
            "description": "Payment for order No. 1234",
            "parameters": {
                "orderid": 1234
            }
        }
    ],
    "allowance": {
        "optional": true,
        "data": {
            "id": 784,
            "transaction_key": "pDAlAZ3z",
            "created_at": 1355314332,
            "status": "active",
            "currency": "EUR",
            "wallet": 14471,
            "confirmed_at": 1355314392,
            "valid": {
                "until": 1357992732
            },
            "description": "Allowance for weekly services (5 weeks)",
            "max_price": 1500,
            "max_price_decimal": "15.00",
            "limits": [
                {
                    "max_price": 300,
                    "max_price_decimal": "3.00",
                    "time": 604800
                }
            ]
        }
    }
}

Getting receipt for confirmed transaction

Informacija This feature is not available by default and is enabled only for some clients

In case user is identified at some location (for offline or gateway clients), receipt with transaction information can be printed for the user.

Request

GET https://wallet.paysera.com/rest/v1/transaction/:transaction_key/receipt?locale=:locale&width=:width

Parameters

transaction_key: key of the transaction
locale: optional parameter; locale for the text translation. Currently available locales: en, lt, ru
width: optional parameter; maximum symbol count in one line. Longer lines will be broken into separate ones

Response data structure

Parametras

Tipas

Pastabos

Aprašymas

text_for_customer

string

always

Text for the customer. New lines are separated by \r\n characters (CR + LF)

text_for_merchant

string

always

Text for the merchant. New lines are separated by \r\n characters (CR + LF)

Example request

GET /rest/v1/transaction/pDAlAZ3z/receipt?locale=en HTTP/1.1
Host: wallet.paysera.com
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="ljIHyvUhkBj4C5J68XbMiEZzPsWaR05BXQm13parnLY="

Example response

HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8

{
    "text_for_customer": "Transaction ID: pDAlAZ3zrnMerchant ID: 125rnConfirmed with PIN code",
    "text_for_merchant": "Transaction ID: pDAlAZ3zrnWallet ID: 14471rnConfirmed with PIN code"
}

Transaction Resource

Automatically created transactions

Create transaction

Request

Request body structure

Allowance data structure

User data structure

Response data structure

Errors

Example request for grouping already created payments

Example response

Example request for creating payment and assigning optional allowance

Example response

Renew transaction

Request

Parameters

Response data structure

Example request

Get transaction information

Request

Parameters

Response data structure

Meaning of transaction status codes

Example request

Example response

Search transactions

Request

Parameters

Response data structure

Metadata information structure

Example request when searching for reserved transactions

Example response

Revoke transaction

Request

Parameters

Response data structure

Example request

Example response

Confirm transaction

Request

Parameters

Request data structure

Structure of price object

Response data structure

Errors

Example request

Example request with price reduction

Example response

Getting receipt for confirmed transaction

Request

Parameters

Response data structure

Example request

Example response