Crie uma cobrança apresentada como QR Code que o cliente lê e paga com o MULTICAIXA Express, obtenha novamente a imagem do QR e devolva pagamentos QR Code.
Criar QR Code
Cria uma cobrança e devolve o respetivo QR Code como imagem PNG. O cliente lê-o e paga com o MULTICAIXA Express. Uma cobrança está sempre associada a um QR Code.
config.typeéSTATICouDYNAMIC. Nos QR CodesDYNAMIC,maxTransactionseendDatesão ignorados.- Qualquer
notify.callbackUrlenviado é substituído pelo URL de callback configurado pela IZI Pay; os pagamentos aceites são reencaminhados para o callback do comerciante. - A resposta contém apenas a imagem. Guarde o
config.referencepara associar a notificação de pagamento à encomenda.
Mostrar ou ler o QR Code não confirma o pagamento. Conclua a encomenda apenas após a notificação de backend com status: ACCEPTED.
path Parameters
merchantIdIdentificador do comerciante.
Criar 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.
Criar QR Code › Responses
Imagem do QR Code.
Obter imagem do QR Code
Devolve o QR Code de uma cobrança existente como imagem PNG, por exemplo para o voltar a mostrar. O chargeId é devolvido por Criar cobrança deeplink.
path Parameters
merchantIdIdentificador do comerciante.
chargeIdIdentificador da cobrança.
Obter imagem do QR Code › Responses
Imagem do QR Code.
Devolução de pagamento QR Code
Devolve um pagamento efetuado com QR Code (ou deeplink). O montante tem de ser igual ou inferior ao da cobrança e um pagamento só pode ser devolvido uma vez. Por debitar o comerciante, é obrigatório o supervisor do terminal.
path Parameters
posIdIdentificador do terminal (ponto de venda).
paymentIdIdentifier of the QR Code payment (the transaction id received in the payment notification).
Devolução de pagamento QR Code › 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.
Devolução de pagamento QR Code › Responses
Refund processed. Check errorCode/errorType: when both are empty, the refund was accepted.
idTransaction identifier.
errorTypeerrorCodeerrorMessage