Documentação das APIs

Cria uma transação via pix com split dos valores

Este método permite criar uma transação com o 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. Caso a mesma seja confirmada dentro do prazo proposto, esta será confirmada na URL de confirmação do comércio, o qual deve consultar o estado da mesma. Caso o tempo máximo seja ultrapassado, está será confirmada posteriormente como cancelada.


A versão “split” permite distribuir automaticamente os créditos do pagamento via Pix em diversas contas K8Bank, para o caso de receitas rateadas, evitando a necessidades de repasses posteriores, sendo útil para casos de múltiplas empresas prestadoras de serviço de um grupo ou de múltiplos profissionais liberais.

Requisição

CampoTipoDescrição
ValorNumérico com 2 decimaisValor da compra
SegundosExpiracaoNuméricoTempo de validade do pagamento via Pix, em segundos, sendo aceitos valores de 300 (5 minutos) até 2592000 (30 dias).
URLConfirmacaoTextoURL de confirmação do comércio para indicar que o pagamento está em estado final.
ClienteDescricaoTextoDescrição da compra.
ClienteIPTextoIP do cliente final da transação.
ClienteCPFCNPJTextoCPF/CNPJ do cliente final da transação.
ClienteNomeTextoNome do cliente final da transação.
ClienteEMailTextoE-Mail do cliente final da transação (opcional).
NumeroPedidoTextoNúmero interno do pedido.
SplitValoresTransacaoSplit[]Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas do K8Bank, a partir do código de cliente e do valor respectivo.

Resposta

CampoTipoDescrição
RetornoTextoRetorno da chamada, podendo possuir os valores OK ou ERRO.
DetalhesErroTextoDetalhes do erro gerado, caso o retorno seja ERRO.
IdentificadorTextoIdentificador da transação.
QRCodeTextoTextoTexto do QRCode para realizar o pagamento via Pix.
QRCodeImagemTextoURL que gera a imagem do QRCode relacionado a transação.
Language
Authorization
OAuth2
Click Try It! to start a request and see the response here!