Skip to main content

Domestic Transfers

Good to know

The only difference between domestic HUF transfer, SEPA and foreign currency transfer is in the payment submission and its status query. There is no difference in consent creation and its status query, so for SEPA and foreign currency transfers, the procedure described for domestic HUF transfers applies.

POST {{baseURL}}/v1/consent/create

http headers:

x-correlation-id: {{$uuid}}
x-request-id: {{$uuid}}
x-api-key: {{$var1}}
x-jws-signature: {{$var2}}
request body
{
  "signer": "87414614",
  "expiryDate": "2022-10-09T15:20:21.087Z",
  "accountList": [
    "HU29120670080010034200100009"
  ]
}
response body - successful
response body
{
"consentId": "1521"
}
POST {{baseURL}}/v1/consent/query

http headers:

x-correlation-id: {{$uuid}}
x-request-id: {{$uuid}}
x-api-key: {{$var1}}
x-jws-signature: {{$var2}}
request body
{
  "consentId": "1521",
  "statusFilterList": [
    "in_progress",
    "approved",
    "declined",
    "revoked"
  ],
  "needExpired": true
}
response body - successful
response body
{
"consentList": [
    {
        "consentId": "1521",
        "signer": "87414614",
        "status": "in_progress",
        "expiryDate": "2022-10-09T15:20:21.090Z",
        "accountList": [
            "HU29120670080010034200100009"
        ]
    }
]
}

Payment submission sample call​

POST {{baseURL}}/v1/payment/domestic/init

http headers:

x-correlation-id: {{$uuid}}
x-request-id: {{$uuid}}
x-api-key: {{$var1}}
x-jws-signature: {{$var2}}
request body
{
    "consentList": [
        "3687",
        "3688"
    ],
    "paymentData": {
        "debtorAccount": {
            "iban": "HU91120113510184523800100006"
        },
        "requestedExecutionDate": "2026-02-20",
        "paymentInformationId": "0538829",
        "payments": [
            {
                "instructionIdentification": "3206170",
                "instructedAmount": {
                    "currency": "HUF",
                    "amount": "1"
                },
                "creditorName": "Teszt Elek",
                "creditorAccount": {
                    "iban": "HU77120836000041718100100009"
                }
            }
        ]
    }
}

Possible additional data content:

request body
{
   "consentList":[
      "1111",
      "2222"
   ],
   "paymentData":{
      "debtorAccount":{
         "iban":"HU29120670080434034200100009"
      },
      "requestedExecutionDate":"2022-01-13",
      "paymentInformationId":"example-{{$uniqueID}}",
      "categoryPurpose":{
         "categoryPurposeCode":"EPAY"
      },
      "payments":[
         {
            "instructionIdentification":"example-instrid",
            "endToEndIdentification":"example-e2e",
            "instructedAmount":{
               "currency":"HUF",
               "amount":"5000"
            },
            "ultimateDebtorName":"Gazdag Géza",
            "creditorName":"Teszt Elek",
            "creditorAddress":{
               "country":"HU",
               "address":"Bp XIII Agora irodaház"
            },
            "creditorAccount":{
               "iban":"HU05120106280142696100100000"
            },
            "ultimateCreditorName":"Beszedetélen Alapítvány",
            "purposeCode":"EPAY",
            "remittanceInformationUnstructured":"remittance info"
         }
      ]
   }
}

See all available optional fields in the field descriptions.

response body - successful
response body
{
"originalPaymentInformationIdentification": "example-wsiV11G_H ",
"paymentInformationStatus": "ACTC",
"packageId": "RP0001748616",
"payments": [
    {
        "originalInstructionId": "example-instrid",
        "sequenceNumber": "00000001",
        "localReference": "ABK22A0000000027",
        "transactionIndividualStatus": "ACTC"
    }
]
}

Payment status query sample call​

POST {{baseURL}}/v1/payment/domestic/query

http headers:

x-correlation-id: {{$uuid}}
x-request-id: {{$uuid}}
x-api-key: {{$var1}}
x-jws-signature: {{$var2}}
request body
{
  "paymentData": {
    "paymentInformationIdentification": "123_asd",
    "instructionIdentification": "12345_asdfg"
  }
}
response body - successful
response body
{
"packageId": "ABK22A0000000027",
"payments": [
    {
        "transactionIndividualStatus": "ACSC"
    }
]
}