In the redirect flow the user is redirected to Everifin Paygate page where the payment is done. In this flow the client system initializes the payment, redirects and then gets the result - success or failure. This makes the redirect flow much simpler for implementation comparing to the embedded flow.
| Drawio | ||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
Order initialization
In payment order initialization you send the information about the payment to Everifin. Everifin responds with a an order ID, processable payment ID and redirect link to Everifin Paygate page.
...
| Code Block |
|---|
POST {everifin_url}/api/v1v2/linkorders
{
"instructionId": "ABCD11234",
"amount" : 1.05,
"currency": "EUR",
"recipientIban": "SK132465798132456",
"recipientName": "The best e-shop in the world",
"variableSymbol": "0000000001",
"constantSymbol": "0308",
"specificSymbol": "0000000003",
"reference": null,
"redirectUrl": "https://thebesteshopintheworld.com",
"paymentMessage": "Payment for The best eshop",
} |
...
Field | Type | Optional | Description |
|---|---|---|---|
id | uuid, unique | no | Order ID |
processablePaymentId | uuid, unique | no | Payment ID (not your instruction id from the request) |
link | text | no | Redirect URL to Everifin Paygate |
status | enum | no | Payment Order status |
| Code Block |
|---|
200:
{
"meta": {
"status": "SUCCESS"
},
"data": {
"id": "bf4f2fa8-9426-441d-b450-67a5c801a9ef",
"processablePaymentId": "372f9684-184b-437b-b974-e3331bbc879a",
"link": "{{redirect-to-everifin}}",
"status": "CREATEDUNPAID"
}
} |
Your application should then use the link from the response to redirect the customer to that particular linkURL. Once the entire payment process is complete, the customer will be redirected back to your application at the URL registered in the first step. The query parameter id is added to redirect URL containing the same value as in the field id in response of payment link endpoint.
...