Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Field

Type

Optional

Description

amount

number

(0.01 - 9999999999)

no

Amount of the payment.

currency

text, valid currency

(min/max 3 chars)

no

Currency of the payment. Must be a valid currency code, e.g. EUR, CZK, PLN.

paymentDate

ISO 8601 datetime

yes

Date when the payment should be executed. Current date of not provided

recipientIban

text, valid iban

(max 50 chars)

no

Your IBAN account number to collect the payment (not payer`s IBAN). This IBAN must be whitelisted in Everifin Paygate, otherwise the payment will be deniedwhere the money should be sent to.

recipientName

text

(max 140 chars)

yes

Your name in case you don’t want to use the registered name.

This name will appear in payer’s bank transaction as recipient of the money.

recipientBankBic

text, valid BIC

yes

BIC of the integrator's bank accountsenderBankId

text, valid bank identifier in Everifin

yes

ID of the bank selected for the payment

senderIban

text, valid iban

(max 50 chars)

yes

IBAN of sender's sender’s (your) bank account, . if known at the time of order creation

variableSymbol

numeric text

(max 10 chars)

yes

Symbol for SK/CZ market. Cannot be combined with reference.

constantSymbol

numeric text

(max 10 chars)

yes

Symbol for SK/CZ market. Cannot be combined with reference.

specificSymbol

numeric text

(max 4 chars)

yes

Symbol for SK/CZ market. Cannot be combined with reference.

reference

text

(max 35 chars)

yes

Payment reference. Cannot be combined with symbols.

customerEmail

valid email

yes

Email of the customer

redirectUrl

text

(max 5000 chars)

no

Redirect URL back to your system. This redirect URL has to be whitelisted in Everifin Paygate.

It must be string satisfying URL rules. E.g. hostname must contain at least one dot (for local development URL like this can be used: http://yourapp.local/xyz).
Using of URL like this for local development requires some locally running proxy rerouting to your app running on localhost.Custom query parameters are accepted.

paymentMessage

text

(max 140 chars)

yes

Message to your customerfor recipient. This message will be visible in his bank transaction as description of the transfer.

recipientNameexternalId

externalId

Free text, maximum 255 characters

yes

Free text

(max 140 chars)

yes

Your name in case you don’t want to use the registered name.

This name will appear in payer’s bank transaction as recipient of the money.

userLocale

language code

yes

If you want to force Everifin Paygate UI language for your customer, use this property. List of supported languages: 'en', 'sk', 'cs' (it is being extended continuously) . If not defined, browser language will be applied.

refundLimitPercentage

Valid positive number (Integer or floating up to 2 decimals) or zero

yes

Specifies the refund limit of an order. If value equals 100, refund can be created up to the amount of an order. If set to 0, the refund limit is not applied, i.e. any amount can be refunded.

Can be used to match the order with data in client's systems. Might be different from instructionId, because the instructionId could be unique for each payment within an order., maximum 255 characters

yes

Can be used to match the payment with data in your systems.

counterpartyAddress

Free text, maximum 255 characters

yes

Object holding information about recipient address. Fields:

  • streetName - free text

  • streetNumber - free text

  • city - free text

  • zip - free text

  • countryCode - ISO alpha-3 code of the country

priority

Enum

yes

possible values:

  • NORMAL

  • HIGH

  • INSTANT

Example call

Code Block
POST {{everifin_api_url}}/api/v1/v2payments/orderssingle

{
   "amount": 1.00,
    "instructionIdcurrency": "ABCD11234EUR",
    "amountpaymentDate": null,
    "recipientIban": 1.05 "{{counterparty_iban}}",
    "recipientName": "Customer name",
    "currencyrecipientBankBic": null,
    "EURvariableSymbol": null,
    "recipientIbanspecificSymbol": null,
    "SK132465798132456constantSymbol": null,
    "recipientNamereference": null,
    "The best e-shop in the world"paymentMessage": null,
    "redirectUrl": "https://web.example",
    "variableSymbolexternalId": "0000000001ABC123",
    "counterpartyAddress": {
        "constantSymbolstreetName": "0308Testova",
        "specificSymbolstreetNumber": "000000000310",
        "referencecity": null,"Testovo",
        "redirectUrlzip": "https://thebesteshopintheworld.com""123456",
        "countryCode": "SVK"
    },
    "paymentMessagesenderIban": "{{your_iban}}",
    "priority": null
}

Response

Field

Type

Optional

Description

id

number

no

Payment

...

ID

Example response

Code Block
200:
{
    "meta": {
        "status": "SUCCESS"
    },
    "data": {
        "id": "12"
    }
}