Cria uma transação via Pix para marketplace com split dos valores, tendo como participantes o Marketplace e os Sellers.
Cada participante é identificado pelo seu ClienteId. O Marketplace deve cadastrar os sellers previamente para utilizar seus respectivos IDs.
Uma transação de split:
- Requer entre 2 e 10 participantes, todos devidamente informados por seu ClienteId e qual seu valor de participação sobre o valor total da transação.
O tipo de Pix pode ser:
- E = Estático
- D = Dinâmico
Requisição
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| 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 | Sim |
| Tipo | Texto | Informar D = para tipo de pix dinâmico, e E = para tipo de pix estático | Sim |
| Valor | Numérico com 2 decimais | Valor total da compra | Sim |
| SegundosExpiracao | Inteiro | Tempo de validade do pagamento via Pix, em segundos, sendo aceitos valores de 300 até 2592000 (30 dias) para Pix Estático e 86400 (24 horas) para Pix Dinâmico | Não |
| DataVencimento | Data | Data de vencimento no formato YYYY-MM-DD | Não |
| DataLimitePagamento | Data | Data limite para pagamento | Não |
| URLConfirmacao | Texto | URL para callback de confirmação | Não |
| ClienteDescricao | Texto | Descrição da compra | Sim |
| ClienteIP | Texto | IP do cliente final | Sim |
| ClienteCPFCNPJ | Texto | CPF ou CNPJ do cliente final | Sim |
| ClienteNome | Texto | Nome completo do cliente final, tamanho máximo de 100 caracteres | Sim |
| ClienteEmail | Texto | E-mail do cliente final | Não |
| NumeroPedido | Texto | Número interno da transação,tamanho máximo de 20 caracteres | Não |
| Referencia | Texto | Referência de controle | Não |
| TipoMulta | Texto | Tipo da multa aplicada | Não |
| ValorMulta | Numérico com 2 decimais | Valor da multa | Não |
| TipoJuros | Texto | Tipo de juros aplicado | Não |
| ValorJuros | Numérico com 2 decimais | Valor do juros | Não |
| TipoDesconto | Texto | Tipo do desconto aplicado | Não |
| ValorDesconto | Numérico com 2 decimais | Valor do desconto | Não |
| DescontosDataFixa | Array | Lista de descontos por data fixa | Não |
Enums utilizados
TipoMultaArbi
| Valor | Nome | Descrição |
|-------|-----------------|-----------------------------------------------|
| 0 | NaoTemMulta | Não será aplicada multa |
| 1 | ValorFixo | Multa será um valor fixo |
| 2 | ValorPercentual | Multa será um percentual do valor total |
TipoJurosArbi
| Valor | Nome | Descrição |
|-------|--------------|-----------------------------------------------|
| 1 | ValorAoDia | Juros em valor fixo por dia |
| 2 | TaxaMensal | Juros aplicados como taxa percentual mensal |
| 3 | Isento | Sem cobrança de juros |
TipoDescontoArbi
| Valor | Nome | Descrição |
|-------|------------------------------|------------------------------------------------------------------------|
| 0 | NaoTemDesconto | Sem desconto |
| 1 | ValorFixoAteDataInformada | Desconto fixo até a data limite |
| 2 | PercentualADataInformada | Desconto percentual até a data limite |
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| Retorno | Texto | OK ou ERRO |
| DetalhesErro | Texto | Detalhes do erro (quando houver) |
| Identificador | Texto | Identificador único da transação |
| QRCodeTexto | Texto | Código Pix em formato de texto |
| QRCodeImagem | Texto | URL da imagem do QRCode gerado |