post https://pagamentos.k8bank.com.br/PagamentosAPI/api/CriaTransacaoPix
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.
Diferenças entre Pix Estático e Pix Dinâmico
Atualmente nosso gateway dispõe de 2 modelos de pix, sendo diferenciados no parâmetro “Tipo”, sendo E (para estático) e D (para dinâmico). Além disso, o payload disponível para o pix dinâmico é ligeiramente diferente.
A principal diferença entre eles está no fato de que o Pix Dinâmico aceita data de vencimento, descontos, multa e/ou juros, até de ser utilizável apenas uma vez.
| Campo | Tipo | Descrição |
|---|
| Tipo | Texto | Informar D = para tipo de pix dinâmico, e E = para tipo de pix estático |
| Valor | Numérico com 2 decimais | Valor da compra |
| SegundosExpiracao | Numérico | Tempo de validade do pagamento via Pix, em segundos, sendo aceitos valores de 300 (5 minutos) até 2592000 (30 dias). |
| URLConfirmacao | Texto | URL de confirmação do comércio para indicar que o pagamento está em estado final. |
| ClienteDescricao | Texto | Descrição da compra. |
| ClienteIP | Texto | IP do cliente final da transação. |
| ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final da transação. |
| ClienteNome | Texto | Nome do cliente final da transação. |
| ClienteEMail | Texto | E-Mail do cliente final da transação (opcional). |
| NumeroPedido | Texto | Número interno do pedido. |
| Referencia | Texto | Referência para localização futura do boleto (opcional) |
| TipoMulta | Texto | Tipo da multa a ser aplicada, sendo os valores possíveis: NaoTemMulta, ValorFixo ou ValorPercentual. |
| ValorMulta | Numérico com 2 decimais | Valor da multa a ser aplicada. |
| TipoJuros | Texto | Tipo do juro a ser aplicado, sendo os valores possíveis: Isento, ValorAoDia ou TaxaMensal. |
| ValorJuros | Numérico com 2 decimais | Valor do Juros a ser aplicado. |
| TipoDesconto | Texto | Tipo do desconto a ser aplicado, sendo os valores possíveis: NaoTemDesconto, ValorFixoAteDataInformada ou PercentualADataInformada. |
| ValorDesconto | Numérico com 2 decimais | Valor do desconto a ser aplicado. |
| DescontosDataFixa | Array | Desconto concedido por data fixa, sendo composto por: Data (no formato YYYY-MM-DD) e ValorDesconto(numérico com 2 casas decimais). |
| 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. |
