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
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.
ClientIdTextoId do seller cadastrado
ValorNumérico com 2 decimaisValor da compra
ValorRoyaltiesNuméricoValor da parte da transação referente ao seller ou marketplace (opcional)
TipoTextoInformar D= para tipo de pix dinâmico, e E= para tipo de pix estático
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.
ReferenciaTextoReferência para localização futura do boleto (opcional)
TipoMultaTextoTipo da multa a ser aplicada, sendo os valores possíveis: NaoTemMulta, ValorFixo ou ValorPercentual.
ValorMultaNumérico com 2 decimaisValor da multa a ser aplicada.
TipoJurosTextoTipo do juro a ser aplicado, sendo os valores possíveis: Isento, ValorAoDia ou TaxaMensal.
ValorJurosNumérico com 2 decimaisValor do Juros a ser aplicado.
TipoDescontoTextoTipo do desconto a ser aplicado, sendo os valores possíveis: NaoTemDesconto, ValorFixoAteDataInformada ou PercentualADataInformada.
ValorDescontoTextoNumérico com 2 decimais
DescontosDataFixaArrayDesconto concedido por data fixa, sendo composto por: Data (no formato YYYY-MM-DD) e ValorDesconto(numérico com 2 casas decimais).

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
Credentials
OAuth2
Click Try It! to start a request and see the response here!