---
title: "Cria uma transação via boleto"
method: POST
path: "/api/marketplace/boleto"
tags: ["Marketplace"]
---
# Cria uma transação via boleto
`POST /api/marketplace/boleto`
## Request
- Base URL: `https://pagamentos.meuk8.com.br/PagamentosAPI`
- URL: `https://pagamentos.meuk8.com.br/PagamentosAPI/api/marketplace/boleto`
- Auth: OAuth 2
- Password
- Token URL: `/BknBankPagamentosAPI/token` scopes: `BknBankPagamentosAPI`
Cria uma transação via boleto para marketplace com split dos valores entre o marketplace e sellers participantes.
- O campo **SplitValores** deve conter entre **2 e 10 participantes**, cada um identificado por seu **ClienteId** e valor de participação.
- O Marketplace deve cadastrar previamente os sellers antes de incluí-los como participantes (utilize o endpoint **/seller**).
- A transação gerada **precisa ser decidida** após a criação; caso contrário, os valores permanecem suspensos.
### Requisição
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** |
|---------------------------|----------------------------|-------------------------------------------------------------------------------------------------------------------|------------------|
| **SplitValores** | **Array de Objeto** | **Lista de participantes do split** | **Sim** |
| ClienteId | GUID | Identificador do Cliente | Sim |
| Valor | Número | Valor da Transação | Sim |
| ValorRoyalties | Número | Valor da parte da transação referente ao seller ou marketplace | Não |
| Decisao | Texto | Informa se o split já está aprovado ou não para efetivação da transferência para o recebedor | Não |
|--|--|--|--|
| Valor | Numérico | Valor total da transação | Sim |
| DataVencimento | Data | Data de vencimento do boleto | Sim |
| DataLimitePagamento | Data | Data limite para pagamento | Não |
| URLConfirmacao | Texto | URL chamada quando pagamento for finalizado | Não |
| ClienteDescricao | Texto | Descrição da compra | Sim |
| ClienteIP | Texto | IP do cliente | Sim |
| ClienteCPFCNPJ | Texto | CPF ou CNPJ do cliente final | Sim |
| ClienteNome | Texto | Nome do cliente final | Sim |
| ClienteEmail | Texto | E-mail do cliente | Não |
| ClienteEndereco | Texto | Endereço do cliente | Sim |
| ClienteBairro | Texto | Nome do bairro | Sim |
| ClienteCidade | Texto | Nome da cidade | Sim |
| ClienteCEP | Texto | CEP | Sim |
| ClienteUF | Texto | Unidade da federação (UF), ex: SP, RJ | Sim |
| ClienteDDD | Texto | DDD do telefone | Não |
| ClienteNumeroCelular | Texto | Número do celular | Não |
| NumeroPedido | Texto | Número do pedido no sistema do marketplace | Não |
| TipoMulta | Texto | Tipo da multa a ser aplicado | Não |
| ValorMulta | Numérico | Valor da multa | Não |
| Multa | Numérico | Valor da multa | Não |
| TipoJuros | Texto | Tipo de juros a ser aplicado | Não |
| ValorJuros | Numérico | Valor dos juros | Não |
| TipoDesconto | Texto | Tipo de desconto a ser aplicado | Não |
| ValorDesconto | Numérico | Valor do desconto | Não |
| DataDesconto | Data | Data de validade do desconto | Não |
| ValorDesconto2 | Numérico | Segundo valor de desconto | Não |
| DataDesconto2 | Data | Data de validade do segundo desconto | Não |
| ValorDesconto3 | Numérico | Terceiro valor de desconto | Não |
| DataDesconto3 | Data | Data de validade do terceiro desconto | Não |
| Mensagem2 | Texto | Mensagem personalizada no boleto | Não |
| Mensagem3 | Texto | Mensagem personalizada no boleto | Não |
| Mensagem4 | Texto | Mensagem personalizada no boleto | Não |
| **Mensagem5** | **Texto** | **Este campo não deve ser utilizado** | **Não** |
| NumeroDocumento | Texto | Número do documento | Não |
| Referencia | Texto | Referência para controle | Não |
| RetornarBase64 | Booleano | Se true, retorna o PDF codificado em Base64 | Não |
| EntradaCNAB | Booleano | Se true, indica origem CNAB | Não |
| NossoNumero | Texto | Nosso número do boleto | Não |
| Carteira | Texto | Número da carteira | Não |
| ArbiCnabNumeroOperacao | Texto | Número da operação utilizada no CNAB | Não |
### Enums
**TipoMultaArbi**
| Valor | Descrição |
|------------------|-------------------------------------|
| NaoTemMulta (0) | Não aplica multa |
| ValorFixo (1) | Aplica multa com valor fixo |
| ValorPercentual (2)| Aplica multa percentual sobre valor |
**TipoJurosArbi**
| Valor | Descrição |
|-----------------|---------------------------------------------|
| ValorAoDia (1) | Aplica juros por valor fixo ao dia |
| TaxaMensal (2) | Aplica juros com taxa mensal |
| Isento (3) | Sem juros |
**TipoDescontoArbi**
| Valor | Descrição |
|-------------------------------|----------------------------------------------------|
| NaoTemDesconto (0) | Sem desconto |
| ValorFixoAteDataInformada (1) | Desconto fixo até determinada data |
| PercentualADataInformada (2) | Desconto percentual até determinada data |
### Resposta
| **Campo** | **Tipo** | **Descrição** |
|-------------------|----------|------------------------------------------------------------|
| Retorno | Texto | OK ou ERRO |
| DetalhesErro | Texto | Detalhes em caso de erro |
| Identificador | Texto | Identificador da transação criada |
| NossoNumero | Texto | Nosso número do boleto gerado |
| LinhaDigitavel | Texto | Linha digitável do boleto |
| CodigoBarras | Texto | Código de barras do boleto |
| BoletoPDF | Texto | PDF do boleto em formato Base64 (caso RetornarBase64 = true) |
| CodigoErro | Texto | Código interno do erro |
## Headers
- `Aeskey` string, required
## Request body
- BknBankPagamentosBusinessCriaTransacaoBoletoSplitRequest
- `SplitValores` BknBankPagamentosBusinessTransacaoSplit[], required
- `ClienteId` string, uuid
- `Valor` number, double
- `ValorRoyalties` number, double
- `Decisao` string
- `Valor` number, double
- `DataVencimento` string, date-time
- `DataLimitePagamento` string, date-time
- `URLConfirmacao` string
- `ClienteDescricao` string, required
- `ClienteIP` string
- `ClienteCPFCNPJ` string, required
- `ClienteNome` string, required
- `ClienteEmail` string
- `ClienteEndereco` string
- `ClienteBairro` string
- `ClienteCidade` string
- `ClienteCEP` string
- `ClienteUF` string
- `ClienteDDD` string
- `ClienteNumeroCelular` string
- `NumeroPedido` string
- `TipoMulta` 'NaoTemMulta' | 'ValorFixo' | 'ValorPercentual'
- `ValorMulta` number, double
- `Multa` number, double
- `TipoJuros` 'ValorAoDia' | 'TaxaMensal' | 'Isento'
- `ValorJuros` number, double
- `TipoDesconto` 'NaoTemDesconto' | 'ValorFixoAteDataInformada' | 'PercentualADataInformada'
- `ValorDesconto` number, double
- `DataDesconto` string, date-time
- `ValorDesconto2` number, double
- `DataDesconto2` string, date-time
- `ValorDesconto3` number, double
- `DataDesconto3` string, date-time
- `Mensagem2` string
- `Mensagem3` string
- `Mensagem4` string
- `Mensagem5` string
- `NumeroDocumento` string
- `Referencia` string
- `RetornarBase64` boolean
- `EntradaCNAB` boolean
- `NossoNumero` string
- `Carteira` string
- `ArbiCnabNumeroOperacao` string
- `NotaFiscal` string
- `CNABArquivo` string
## Response `200`
Criacao da transacao
- BknBankPagamentosBusinessCriaTransacaoBoletoSplitResponse
- `Retorno` 'OK' | 'ERRO'
- `DetalhesErro` string
- `Identificador` string
- `NossoNumero` string
- `LinhaDigitavel` string
- `CodigoBarras` string
- `BoletoPDF` string
- `CodigoErro` string
## Other responses
- `400`: Erro de validação ou parâmetros inválidos
- `500`: Erro interno
## Changes
- **2026-11-03** `a8b4ea0aa298`: 9 info
- removed the pattern `^(\d)+$` from the request property `ClienteCPFCNPJ` (media type: application/json)
- removed the pattern `^(\d)+$` from the request property `ClienteCPFCNPJ` (media type: text/json)
- removed the pattern `^(\d)+$` from the request property `ClienteCPFCNPJ` (media type: application/xml)
- removed the pattern `^(\d)+$` from the request property `ClienteCPFCNPJ` (media type: text/xml)
- …5 more
[Operation history](https://skmtc.dev/meuk8/apis/k8-fintech/changes/api/marketplace/boleto/post.md)
---
[API](https://skmtc.dev/meuk8/apis/k8-fintech.md) - [All operations](https://skmtc.dev/meuk8/apis/k8-fintech/llms.txt) - [OpenAPI document](https://skmtc.dev/meuk8/apis/k8-fintech/revisions/a8b4ea0aa298?raw)