post https://pagamentos.k8bank.com.br/PagamentosAPI/api/CriaTransacaoPixSplit
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.
Campo | Tipo | Descrição |
---|
SplitValores | TransacaoSplit[] | 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. |
ClientId | Texto | Id do seller cadastrado |
Valor | Numérico com 2 decimais | Valor da compra |
ValorRoyalties | Numérico | Valor da parte da transação referente ao seller ou marketplace (opcional) |
Tipo | Texto | Informar D= para tipo de pix dinâmico, e E= para tipo de pix estático |
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 | Texto | Numérico com 2 decimais |
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. |