post https://pagamentos.k8bank.com.br/PagamentosAPI/api/CriaTransacaoPixSimples
Este método permite criar uma transação do tipo Pix, sendo que o pagamento deverá ser efetuado pelo cliente final abrindo o aplicativo do banco no qual possua conta e efetuando a leitura do QRCode gerado.
A transação via Pix é criada no estado pendente, e será válida por um determinado tempo definido (SegundosExpiracao). Caso a transação seja paga dentro do prazo proposto, esta será confirmada na URL de confirmação informada pelo integrador, o qual deve consultar o estado da mesma. Caso o tempo máximo seja ultrapassado, a transação terá seu estado alterado para Cancelada e será confirmada na URL de confirmação informada pelo integrador.
Requisição
Campo | Tipo | Descrição | Origatório |
---|---|---|---|
Valor | Numérico com 2 decimais | Valor da compra | Sim |
SegundosExpiracao | Numérico | Tempo de validade do pagamento via Pix, em segundos, sendo aceitos valores de 300 (5 minutos) até 86400 (1 dia). | Sim |
URLConfirmacao | Texto | URL de confirmação do comércio para indicar que o pagamento está em estado final. | Não |
ClienteDescricao | Texto | Descrição da compra. | Não |
ClienteIP | Texto | IP do cliente final da transação. | Não |
ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final da transação. | Não |
ClienteNome | Texto | Nome do cliente final da transação. | Não |
ClienteEMail | Texto | E-Mail do cliente final da transação. | Não |
NumeroPedido | Texto | Número interno do pedido. | Não |
Referencia | Texto | Referência para localização futura da transação. | Não |
Resposta
Campo | Tipo | Descrição |
---|---|---|
Retorno | Texto | Retorno da chamada, podendo possuir os valores OK ou ERRO. |
DetalhesErro | Texto | Detalhes do erro gerado, caso o retorno seja ERRO. |
Identificador | Texto | Identificador da transação. |
QRCodeTexto | Texto | Texto do QRCode para realizar o pagamento via Pix. |
QRCodeImagem | Texto | URL que gera a imagem do QRCode relacionado a transação. |