Create a charge displayed as a QR Code that the customer scans and pays with MULTICAIXA Express, retrieve the QR image again, and refund QR Code payments.
Create QR Code
Creates a charge and returns its QR Code as a PNG image. The customer scans it and pays with MULTICAIXA Express. A charge is always associated with a QR Code.
config.typeisSTATICorDYNAMIC. ForDYNAMICQR Codes,maxTransactionsandendDateare ignored.- Any client-supplied
notify.callbackUrlis replaced by the callback URL configured by IZI Pay; accepted payments are forwarded to your merchant callback. - The response body is the image only. Keep your
config.referenceto match the payment notification to your order.
Showing or scanning the QR Code does not confirm payment. Fulfil the order only after the backend notification with status: ACCEPTED.
path Parameters
merchantIdMerchant identifier.
Create QR Code › Request Body
amountCharge amount. Must be greater than or equal to 1.
posIdTerminal associated with the merchant.
Optional customer notifications. Any client-supplied notify.callbackUrl is replaced by the callback URL configured by IZI Pay.
Create QR Code › Responses
QR Code image.
Refund QR Code payment
Refunds a payment made with a QR Code (or deeplink). The refund amount must be equal to or lower than the charge amount, and a payment can be refunded only once. Because it debits the merchant, the supervisor of the terminal is required.
path Parameters
posIdTerminal (point of sale) identifier.
paymentIdIdentifier of the QR Code payment (the transaction id received in the payment notification).
Refund QR Code payment › Request Body
amountAmount to refund. Equal to or lower than the charge amount.
currencysupervisorIdSupervisor of the terminal (supervisorId from Get terminal).
reasonOptional reason for the refund.
Refund QR Code payment › Responses
Refund processed. Check errorCode/errorType: when both are empty, the refund was accepted.
idTransaction identifier.
errorTypeerrorCodeerrorMessage