Foreign Currency Payment

Foreign Currency Payment – Submission

The process is very similar to SEPA payment submission. Exactly two approved consents are required. Exactly one of the following field pairs/field combinations can have a value in the request:

• amountTypeChoice.instructedAmount / amountTypeChoice.equivalentAmount
• debtor.organisationIdentification / debtor.privateIdentification
• debtor.organisationIdentification.anyBIC / debtor.organisationIdentification.other
• creditorAccount.iban / creditorAccount.other
• creditorAgent.bicfi / creditorAgent.name + creditorAgent.postalAddress Sample call:

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

http headers:

x-correlation-id: {{$uuid}}
x-request-id: {{$uuid}}
x-api-key: {{$var1}}
x-jws-signature: {{$var2}}

request body

{
  "consentList": [
    "3445",
    "3446"
  ],
  "paymentData": {
    "debtorAccount": {
      "iban": "HU41120769100154872900200002"
    },
    "requestedExecutionDate": "2025-12-05",
    "creditTransferTransactionInformation": {
      "chargeBearer": "SHAR",
      "amountTypeChoice": {
        "instructedAmount": {
          "amount": 5,
          "currency": "EUR"
        }
      },
      "creditorAgent": {
        "bicfi": "CHASUS33"
      },
      "remittanceInformation": {
        "unstructured": "Payment for Invoice INV-2023-11-1234 - Electronic components shipment"
      },
      "creditorAccount": {
        "iban": "GB29NWBK60161331926819"
      },
      "instructionPriority": "NORMAL",
      "chargesAccount": {
        "iban": "HU42117730161111101800000000"
      },
      "creditor": {
        "name": "ABC Import Export Corporation"
      }
    },
    "debtor": {
      "organisationIdentification": {
        "anyBIC": "OKHBHUHB"
      }
    },
    "paymentInformationIdentification": "99920250000033"
  }
}

response body - successful

{
  "statusIdentification": "RP000271095320251209172204443471",
  "creationDateTime": "2025-12-09T16:22:04.443539Z",
  "debtorAccount": {
    "iban": "HU41120769100154872900200002"
  },
  "paymentCreationDateTime": "2025-12-09T16:22:03.659291Z",
  "paymentInformationStatus": "ACTC",
  "paymentInformationReason": {
    "reasons": {
      "code": "",
      "proprietary": ""
    },
    "additionalInformation": ""
  },
  "transactionInformationAndStatus": {
    "originalInstructionTraceIdentification": "",
    "transactionIndividualStatus": "ACTC",
    "transactionReason": {
      "reasons": {
        "code": "",
        "proprietary": ""
      },
      "additionalInformation": ""
    }
  }
}

response body - error: duplicated paymentInformationIdentification

{
  "statusIdentification": "RP000271095420251209175644368963",
  "creationDateTime": "2025-12-09T16:56:44.368978Z",
  "debtorAccount": {
    "iban": "HU41120769100154872900200002"
  },
  "paymentCreationDateTime": "2025-12-09T16:56:44.141748Z",
  "paymentInformationStatus": "RJCT",
  "paymentInformationReason": {
    "reasons": {
      "code": "AM05",
      "proprietary": ""
    },
    "additionalInformation": "32-Duplication, Transaction not checked"
  },
  "transactionInformationAndStatus": {
    "originalInstructionTraceIdentification": "",
    "transactionIndividualStatus": "RJCT",
    "transactionReason": {
      "reasons": {
        "code": "AM05",
        "proprietary": ""
      },
      "additionalInformation": "Duplication, Transaction not checked"
    }
  }
}

response body - error: invalid account currency

{
  "statusIdentification": "RP000271095520251209175857930462",
  "creationDateTime": "2025-12-09T16:58:57.930472Z",
  "debtorAccount": {
    "iban": "HU41120769100154872900200002"
  },
  "paymentCreationDateTime": "2025-12-09T16:58:57.75909Z",
  "paymentInformationStatus": "RJCT",
  "paymentInformationReason": {
    "reasons": {
      "code": "",
      "proprietary": "HSR08"
    },
    "additionalInformation": "08-IncorrectTransactionInBatch"
  },
  "transactionInformationAndStatus": {
    "originalInstructionTraceIdentification": "",
    "transactionIndividualStatus": "RJCT",
    "transactionReason": {
      "reasons": {
        "code": "AC09",
        "proprietary": ""
      },
      "additionalInformation": "InvalidAccountCurrency"
    }
  }
}

Foreign Currency Payment – Status Query

Sample call:

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

http headers:

x-correlation-id: {{$uuid}}
x-request-id: {{$uuid}}
x-api-key: {{$var1}}
x-jws-signature: {{$var2}}

request body

{
  "paymentData": {
    "instructionIdentification": null,
    "paymentInformationIdentification": "99920250000033"
  }
}

response body - successful (with found payment)

{
  "paymentStatus": [
    {
      "statusIdentification": "RP000271095320251209172744933973",
      "creationDateTime": "2025-12-09T16:27:44.943Z",
      "originalPaymentInformationIdentification": "99920250000033",
      "debtorAccount": {
        "iban": "HU41120769100154872900200002"
      },
      "paymentCreationDateTime": "2025-12-09T16:22:03.659291Z",
      "paymentInformationStatus": "ACTC",
      "transactionInformationAndStatus": []
    }
  ]
}

response body - successful (without found payment)

{
    "paymentStatus": []
}