IRIS Payments via Provider

Below is the complete IRIS payment flow from the merchant's point of view, step by step.

Step 1 — Prerequisites & Registration for IRIS on the Certified Provider Portal

Before using any IRIS functionality, the merchant must fulfill the following prerequisites:

The merchant must have an active Eurobank bank account.

The merchant must be registered for IRIS through the E-INVOICING Certified Provider Portal.

The registration step is mandatory for the merchant to be able to authenticate successfully to the service.

Step 2 — Initiate the IRIS Payment Request (InitiatePayment)

The merchant system calls the InitiatePayment endpoint to create a time-limited IRIS payment request (valid for 1–3 minutes).
This request also initiates the creation of a QR code that will later be displayed to the final customer (payer).

For more information regarding /InitiatePayment click here:/InitiatePayment

Example Request

{
    "issuerTin": "EL123456789",
    "payeeInfo": {
        "displayName": "Customer's Name",
        "companyName": "Customer's Company Name",
        "tin": "EL234567891"
    },
    "paymentAmount": 124,
    "validityPeriod": 3,
    "orderDescription": "Test Order Description",
    "remittanceInformation": "INV-12345",
    "destination": "test_destination",
    "generateQrCodeImage": false,
    "qrCodeSize": 0,
    "issueDate": "2019-11-24T14:15:22.123Z",
    "branchCode": 0,
    "invoiceTypeCode": "1.1",
    "series": "INV",
    "identifier": "INV-12345",
    "mark": 0,
    "totalNetAmount": 100,
    "totalVatAmount": 24,
    "totalAmount": 124,
    "merchantId": "merchantId",
    "tipAmount": 0
}

Step 3 — Receive InitiatePayment Response & Display QR Code

The merchant receives a successful response containing the fields required to display the QR code to the final customer.

{
    "endToEndDiasId": "string",
    "authorisationRequestId": "string",
    "qrCode": "string",
    "qrCodeImage": "string",
    "createdAt": "2019-11-24T14:15:22.123Z",
    "expiresAt": "2019-11-24T14:15:22.123Z"
    "signedDataInput": "string",
    "signature": "string"
}

If the merchant wants the Provider to generate the QR image :

{
    "generateQrCodeImage": true,
    "qrCodeSize": 300 // desired qrCodeSize
}

Step 4 — Check the Payment Status (GetPaymentStatus)

In order for the merchant to check the Payment Status, he needs to make a GET request to the API:

Example
GET /paymentsapi/IrisPayments/GetPaymentStatus?endToEndDiasId=1234567890

For more information regarding /GetPaymentStatus click here: /GetPaymentStatus

Polling Rule

After the QR code is displayed to the final customer, the merchant system must begin polling the GetPaymentStatus endpoint every 5 seconds to retrieve the updated payment status.

{
    "endToEndDiasId": "string",
    "paymentStatus": "Completed",
    "paymentStatusDescription": "string",
    "completedAt": "2019-11-24T14:15:22.123Z",
    "isFinalStatus": true
}

Status	Meaning
Pending	Customer has not yet approved the payment. Continue polling.
Completed	Payment was successfully completed. Proceed to Step 5.
Expired	QR code validity window ended without payment. Merchant must restart the flow.
Failed	The payment failed. Merchant must restart the flow.

Step 5 — Finalize the Transaction & Send Final JSON to Certified Provider

When the merchant receives paymentStatus = Completed, the transaction is successful.
The merchant must now prepare the final JSON document that includes the IRIS payment method data and submit it to the Certified Provider to obtain the final MARK.

{
  "paymentMethods": [
    {
      "paymentMethodTypeCode": 8, // Mandatory
      "paymentMethodType": "IRIS", // Mandatory
      "amount": 3548.88, // PaymentAmount from InitiatePayment request
      "TransactionId": "string", // AuthorizationRequestID from InitiatePayment response
      "TerminalID": "string", // MerchantId for Provider IRIS
      "TipAmount": 0.00,
      "ProvidersSignature": "string", // Signature from InitiatePayment response
      "PosInput": "string" // SignedDataInput from InitiatePayment Response (IRIS via Provider)
    }
  ]
}

You can find a full sample regarding transactions via IRIS with Provider here: 1.1 With IRIS via Provider Payment Method

Provider IRIS Documentation

IRIS Payments via Provider#

Step 1 — Prerequisites & Registration for IRIS on the Certified Provider Portal#

Step 2 — Initiate the IRIS Payment Request (InitiatePayment)#

Example Request#

Step 3 — Receive InitiatePayment Response & Display QR Code#

Step 4 — Check the Payment Status (GetPaymentStatus)#

Polling Rule#

Step 5 — Finalize the Transaction & Send Final JSON to Certified Provider#