Calculate reversed authorization amount

Authorization parameter is used in a couple of processes in ZEN. In this case for authorization fee process (allows to charging of transaction costs to the customer) and DCC (dynamic currency change) process.

To use authorizationfee parameter Merchant has to have feature activated. Then, it is possible to display the commission amount on the checkout, which will be charged to the customer for processing the transaction. The amount charged to the customer (added to the base transaction amount) will be returned to the Merchant. The parameter authorizationfee does not exclude charging the fee to the Merchant for processing the transaction.

It is possible to set authorizationfee parameter for one, some or all payment channels.

Request

Header Params

request-id

string

required

A unique identifier generated by requesting client

>= 38 characters<= 1024 characters

Example:

|us04oqdnzFQVr0rITD9/c9OvDRE2sXVfwerv.

Match pattern:

^[a-zA-Z0-9?&:_|\-\/=+.,#\s]+$

Body Params application/json

optional

One of

Calculate reversed amount with session id

Calculate reversed amount with merchant transaction id

sessionId

string

required

<= 128 characters

authorizationAmount

string

required

currency

string

required

authorizationCurrency

string

required

transactionType

string

optional

Transaction types

Default:

TRT_PURCHASE

Example:

TRT_PURCHASE

Match pattern:

^TRT(_[A-Z0-9]+)+$

optional

data

array [object {5}]

required

Example

{
    "sessionId": "string",
    "authorizationAmount": "string",
    "currency": "string",
    "authorizationCurrency": "string",
    "transactionType": "TRT_PURCHASE",
    "ip": "127.0.0.1",
    "data": [
        {
            "paymentMethod": "PME_CARD",
            "paymentChannel": "PCL_CARD",
            "cardOrganization": "COR_VISA",
            "cardBin": "string",
            "cardId": "f16ba382-eb42-481a-b08f-c57bdc9aae24"
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

sessionId

string

optional

merchantTransactionId

string

optional

data

array [object {3}]

required

paymentMethod

string

required

maxFee

string

required

channels

array [object {5}]

required

Example

{
    "sessionId": "string",
    "merchantTransactionId": "string",
    "data": [
        {
            "paymentMethod": "string",
            "maxFee": "string",
            "channels": [
                {
                    "paymentChannel": "string",
                    "cardOrganizations": [
                        {
                            "cardId": "string",
                            "amount": "string",
                            "currency": "string",
                            "organization": "string",
                            "authorization": {
                                "fee": "string",
                                "amount": "string",
                                "baseAmount": "string",
                                "currency": "string",
                                "rate": "string",
                                "rateExpireAt": "string"
                            }
                        }
                    ],
                    "amount": "string",
                    "currency": "string",
                    "authorization": {
                        "fee": "string",
                        "amount": "string",
                        "baseAmount": "string",
                        "currency": "string",
                        "rate": "string",
                        "rateExpireAt": "string"
                    }
                }
            ]
        }
    ]
}

🟠404Record Not Found