Skip to main content

Integration Recommendations

  • clientOrderReference must be unique

    • Using a unique reference per order/transaction in your system helps with debugging and matching processes.

  • Always monitor the expiryUtc value

    • It is recommended to check the link expiration time on the client or server side.

    • For expired links, you can show an appropriate warning to the user on the portal side.

  • Usage of webhookURL

    • Even if the user navigates to successURL / failURL in the browser, it is recommended to use webhookURL for secure server-side transmission of the actual payment result.

  • Dynamic fields (additionalData)

    • Clarify which dynamic fields are defined on the portal and send them with the same keys.

  • Logging and traceability

    • Logging the request body and responses for each HPM request is critical for troubleshooting (especially when matching with clientOrderReference and data.link).