Skip to main content


This page provides an overview of the payments methods provided by the HiPay adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating HiPay within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Payment Methods

Payment MethodTransaction FlowsTransaction Types
VisaFull-Page RedirectCapture, Debit, Preauthorize, Refund, Void
MastercardFull-Page RedirectCapture, Debit, Preauthorize, Refund, Void
BancontactFull-Page RedirectCapture, Debit, Preauthorize, Refund, Void
Bancontact QR CodeFull-Page RedirectCapture, Debit, Preauthorize, Refund, Void

Mandatory parameters for Debit and Preauthorize

Extra DataTypeRequiredDescription
orderidStringtrueUnique order ID
descriptionStringtrueThe order short description
currencyStringtrueBase currency for the order with three-character currency code
amountNumbertrueTotal order amount

Aditional parameters Debit and Preauthorize

Extra DataTypeRequiredDescription
operationStringfalseOperation can be either Sale for automatically submitting for capture or Authorization for manually capturing / void
payment_product_listStringfalseList of payment products to display on the payment page
basketStringfalseShopping cart details
authentication_indicatorStringfalseIf the payment product is a credit or debit card, this parameter specifies whether 3-D secure authentication should be performed for this transaction.

Mandatory parameters for capture and refund

transaction_referenceStringtrueThe unique identifier of the transaction
operationStringtrueThe operation to perform on the transaction: capture, cancel or refund
amountStringtrueAmount is required for partial maintenances. Do not specify amount for full captures or refunds.

Item Parameters

If items are given with the transaction data, the following parameters can or must be given. For capture and refund only items that must be captured or refunded have to be sent.

Alphanumeric characters (a-z, A-Z, 0-9)
trueUnique product reference
item.quantityNumbertrueProduct quantity
item.nameStringtrueProduct description
item.unit_priceDecimal number with explicit decimal pointtruePrice of the item
item.discountstringtrueDiscount amount, always 0 or negative
item.total_amountNumbertrueUnit price X quantity – discount.
. The sum of every "total_amount" must be equal to the "amount" sent in the call and it is automatically calculated
item.extraData.tax_ratestringtrueTax rate in percentage
Alphanumeric characters (a-z, A-Z, 0-9)
trueType of product Possible values are good, discount or fee
Alphanumeric characters (a-z, A-Z, 0-9)
falseEuropean article numbering