Skip to main content

Sample Calls

EAM Init sample call​

The following sample calls were made in a test environment. /v1/eam/rafipay/init With minimal data content:

request body
{
   "paymentInfo": {
       "transactionReference": "ID833171141",
       "transactionAmount": 10,
       "transactionCurrency": "HUF",
       "expiryDateTimeOffset": 5,
       "allowedModes": {
           "qrAllowed": true,
           "nfcAllowed": true,
           "deeplAllowed": false
       },
       "purposeCode": "IPPS",
       "editableFields": {
           "isAmountEditable": false,
           "isRemittanceInformationEditable": false,
           "isCustomerIdEditable": false
       },
       "deviceType": "CASHREGISTER"
   },
   "payeeInfo": {
       "accountNumber": "HU91120113510184523800100006",
       "terminalReference": "TESTEAM01",
       "shopId": "EAMShop001"
   }
}

Possible additional data content:

request body
request
{
    "paymentInfo": {
        "transactionReference": "ID833171141",
        "transactionCurrency": "HUF",
        "transactionAmount": 10,
        "expiryDateTimeOffset": 10,
        "allowedModes": {
            "qrAllowed": true,
            "nfcAllowed": true,
            "deeplAllowed": true
        },
        "remittanceInfo": "hossztesztelesstring123456789123455hossztesztelesstring12345678912345",
        "purposeCode": "IPPS",
        "editableFields": {
            "isAmountEditable": false,
            "isRemittanceInformationEditable": false,
            "isCustomerIdEditable": false
        },
        "invoiceReference": "hossztesztelesstring12345678912345",
        "customerReference": "hossztesztelesstring12345678912345",
        "deviceType": "CASHREGISTER"
    },
    "payeeInfo": {
        "accountNumber": "HU91120113510184523800100006",
        "terminalReference": "hossztesztelesstring12345678912345",
        "shopId": "EAMShop001"
    }
}
response body - successful
response
{
    "paymentReference": "IN260220xIUfh4ADR",
    "creationDateTime": "2026-02-20T12:42:33.6679068Z",
    "expiryDateTimeOffset": 10,
    "paymentUrl": "https://teszt-azonnalifizetes.hu/HCT/3/1//HHHÁ%20HUHÚR%20ZÁRIA%20ERTÉNI%20VÁHHAHHO/HHÁ%20ÚÁ IA%20EZ/HU91120113510184523800100006/HUF10/20260220134233%2B1-0000010/IPPS/hossztesztelesstring123456789123455hossztesztelesstring12345678912345/EAMShop001.RB0A.7.12345678.INNOHUH0/hossztesztelesstring12345678912345/hossztesztelesstring12345678912345/hossztesztelesstring12345678912345/ID464548914_IN260220xIUfh4ADR//___/26.KVFzDdeWIFOmaAcACSArkdKIudcG7WtP1BUICR6dkkpOmIOM4-lqVapHeaLVe6HUG2NRI9d7YUU6Kp2JkwMxzAEalq9k48JOUQY_bJVX0jcY9uE1MomqGnSaWidEgvGq"
}
response body - unsuccessful
response
{
    "errorId": "98812f4a-02b9-422e-ae5b-bc980df79108",
    "errorCode": "ARGUMENT_NOT_VALID",
    "errorDetails": [
        {
            "field": "paymentInfo.invoiceReference",
            "invalidValue": "hossztesztelesstring12345678912345X",
            "errorDescription": "The length of the URL encoded value must be between 0 and 35 characters"
        },
        {
            "field": "paymentInfo.customerReference",
            "invalidValue": "hossztesztelesstring12345678912345X",
            "errorDescription": "The length of the URL encoded value must be between 0 and 35 characters"
        },
        {
            "field": "paymentInfo.remittanceInfo",
            "invalidValue": "hossztesztelesstring123456789123455hossztesztelesstring12345678912345X",
            "errorDescription": "The length of the URL encoded value must be between 0 and 70 characters"
        }
    ]
}

EAM query sample call​

/v1/eam/rafipay/query-by-payment-reference

request body
request
{
  "paymentReference": "IN260220xIUfh4ADR"
}
response body - successful
response
{
    "paymentStatus": "RECEIVED"
}
response body - unsuccessful
response
{
    "errorId": "f930b08c-ee11-4e79-9b6f-d4cfa81a124a",
    "errorCode": "MER_REFERENCE_NOT_FOUND",
    "errorDescription": "The specified reference cannot be found."
}

Cancel EAM sample call​

/v1/eam/rafipay/cancel

request body
request
{
    "paymentReference":"IN260220xIUfh4ADR"
}
response body - successful
response
Status 204
response body - unsuccessful
response
{
    "errorId": "f930b08c-ee11-4e79-9b6f-d4cfa81a124a",
    "errorCode": "MER_NOT_MODIFIABLE_STATUS",
    "errorDescription": "The specified reference cannot be found."
}