...
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). | |||
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:
| |||
priority | Enum | yes | possible values:
|
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"
}
} |