Crie uma cobrança QR Code Payment que uma aplicação móvel abre diretamente no MULTICAIXA Express.
Criar cobrança deeplink
Cria uma cobrança QR Code Payment e devolve um URL mcxwallet:// que abre diretamente o MULTICAIXA Express, sem que o cliente tenha de ler um QR code.
O regresso à aplicação do comerciante não confirma o pagamento. Conclua a encomenda apenas após a notificação de backend com status: ACCEPTED. Consulte GPO → Deeplink para o fluxo completo.
Este endpoint não aceita chave de idempotência. Após um timeout ou resposta incerta, reconcilie antes de repetir.
path Parameters
merchantIdIdentificador do comerciante.
query Parameters
includeQrImageQuando true, a resposta inclui a imagem do QR Code em Base64.
callbackUrlSchemeURL de regresso registado pela aplicação móvel do comerciante, por exemplo merchantapp://payment-result. O MULTICAIXA Express pode usá-lo para devolver o controlo à aplicação. Não é o URL de notificação de pagamento do servidor.
Criar cobrança deeplink › 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.
Criar cobrança deeplink › Responses
Cobrança deeplink criada.
chargeIdUnique identifier of the created charge.
qrRefComplete QR Code Payment payload. Not the charge ID or the order reference.
deeplinkUrlURL that opens MULTICAIXA Express.
deeplinkUrlWithCallbackDeeplink including the application return URL. Returned only when callbackUrlScheme is supplied.
qrCodeBase64Base64 QR Code image. Returned when includeQrImage=true.
amountreferenceMerchant reference supplied in the request.
Status names recognised by the optional application-return flow.