---
title: "Efetua o pagamento de um boleto por meio da utilização de um cartão de crédito"
method: POST
path: "/api/PagueContas/EfetuarPagamento"
tags: ["PagueContas"]
---

# Efetua o pagamento de um boleto por meio da utilização de um cartão de crédito

`POST /api/PagueContas/EfetuarPagamento`

## Request

- Base URL: `https://pagamentos.meuk8.com.br/PagamentosAPI`
- URL: `https://pagamentos.meuk8.com.br/PagamentosAPI/api/PagueContas/EfetuarPagamento`
- Auth: OAuth 2
  - Password
  - Token URL: `/BknBankPagamentosAPI/token` scopes: `BknBankPagamentosAPI`

Este método permite criar uma transação de cartão de crédito, suportando pagamento à vista, parcelado sem juros (lojista) ou parcelado com juros (emissor). Notar que os pagamentos realizados com cartão de crédito são “síncronos”, ou seja, o estado final (Aprovado/Rejeitado) é obtido durante a própria chamada do método, não havendo necessidade de confirmação posterior.
<br /> 

### Requisição 
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** |
|--|--|--|--|
| IdentificadorConsultaCartaoTitular | GUID | Identificador da consulta do cartão titular | Sim |
| IdentificadorDesafio | GUID | Identificador único do desafio | Não |
| CodigoBarrasBoleto | Texto | Codigo de barras do boleto | Sim |
| ValorBoleto | Numérico | Valor do boleto | Sim |
| NomeImpresso | Texto | Nome do cliente impresso no cartão | Sim(1)(3) | 
| DataValidade | Data | Data de validade do cartão | Sim(1) | 
| NumeroCartao | Texto | Número do cartão | Sim(1) | 
| CodigoSeguranca | Texto | Código de segurança no verso do cartão | Sim(1)(3) |
| CardToken  | GUID | Identificador único do token do cartão para transações de recorrência | Não(2) | 
| Valor | Numérico | Valor da compra | Sim | 
| CartaoFormaPagamento | Número |Forma de pagamento do cartão, sendo possível os valores: 0 = À vista; 1 = Parcelado sem juros; 2 = Parcelado com juros| Não(4) | 
| QuantidadeParcelas | Número | Quantidade de parcelas, caso a forma de pagamento seja parcelada.Válidos valores de 2 até 12. Caso seja a vista, pode-se não enviar o valor ou enviar 0 ou 1 | Não |
| ClienteDescricao | Texto | Descrição da compra | Sim | 
| ClienteIP | Texto | IP do cliente final da transação | Não | 
| ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final da transação | Sim | 
| ClienteNome | Texto | Nome do cliente final da transação | Sim | 
| ClienteEmail | Texto | E-mail do cliente final da transação | Não |
| ClienteSexo | Texto | Sexo do cliente final da compra - M (masculino) ou F (feminino) | Não | 
| ClienteDDD | Texto | DDD do telefone do cliente final da compra | Não | 
| ClienteNumeroCelular | Texto | Número do telefone do cliente final da compra | Não | 
| ClienteEndereco | Texto | Endereço do cliente final da compra | Não | 
| ClienteComplemento  | Texto | Complemento do endereço do cliente final da compra | Não | 
| ClienteNumero | Texto | Número do endereço do cliente final da compra | Não |
| ClienteBairro | Texto | Bairro do cliente final da compra | Não | 
| ClienteCidade | Texto | Cidade do cliente final da compra | Não | 
| ClienteCEP | Texto | CEP do cliente final da compra | Não | 
| ClienteUF | Texto | UF do cliente final da compra | Não | 
| NumeroPedido | Texto | Número do pedido e/ou carrinho de compras | Não | 
| Referencia  | Texto | Referência para localização futura da transação | Não |
| PreAutorizar | Booleano | Indica se a transação deve ser pré-autorizada. Enviando como true a transacao fica com o Status de CartaoPreAutorizado | Não |
| AntiFraude | Booleano | Indica se a transação deve passar por verificação antifraude. Enviando como true a transacao fica com o Status de PendenteAntifraude | Não |

(1) Não se torna obrigatório caso o cardToken for informado
(2) Obrigatório se número e código de segurança não forem informados
(3) É obrigatório se o provedor de pagamento for a Valorem, mesmo se tiver informando o cardToken
(4) - Obrigatório informar 1(Parcelado sem juros) ou 2(Parcelado com juros) caso **QuantidadeParcelas** seja maior ou igual a 2.

### Resposta
| **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 | 
| CodigoAutorizacao | Texto | Código de autorização da transação (NIT) (caso seja bem sucedida) | 
| NsuOperacao | Texto | Número de operação da transação(caso seja bem sucedida) | 
| Adquirente | Texto | Adquirente responsável pelo processamento da transação | 
| NumeroAutorizacao | Texto | Número de autorização da transação |

## Headers

- `Aeskey` string, required

## Request body

- BknBankPagamentosBusinessCriaTransacaoCartaoPagueContasRequest
  - `IdentificadorConsultaCartaoTitular` string, uuid, required
  - `IdentificadorDesafio` string, uuid
  - `CodigoBarrasBoleto` string, required
  - `ValorBoleto` number, double, required
  - `NomeImpresso` string
  - `DataValidade` string
  - `NumeroCartao` string
  - `CodigoSeguranca` string
  - `CardToken` string, uuid
  - `Valor` number, double
  - `CartaoFormaPagamento` integer
  - `QuantidadeParcelas` integer
  - `ClienteDescricao` string, required
  - `ClienteIP` string
  - `ClienteCPFCNPJ` string, required
  - `ClienteNome` string, required
  - `ClienteEmail` string
  - `ClienteSexo` string
  - `ClienteDDD` string
  - `ClienteNumeroCelular` string
  - `ClienteEndereco` string
  - `ClienteComplemento` string
  - `ClienteNumero` string
  - `ClienteBairro` string
  - `ClienteCidade` string
  - `ClienteCEP` string
  - `ClienteUF` string
  - `NumeroPedido` string
  - `Referencia` string
  - `PreAutorizar` boolean
  - `AntiFraude` boolean

## Response `200`

Efetuar Pagamento

- BknBankPagamentosBusinessCriaTransacaoCartaoPagueContasRequest
  - `IdentificadorConsultaCartaoTitular` string, uuid, required
  - `IdentificadorDesafio` string, uuid
  - `CodigoBarrasBoleto` string, required
  - `ValorBoleto` number, double, required
  - `NomeImpresso` string
  - `DataValidade` string
  - `NumeroCartao` string
  - `CodigoSeguranca` string
  - `CardToken` string, uuid
  - `Valor` number, double
  - `CartaoFormaPagamento` integer
  - `QuantidadeParcelas` integer
  - `ClienteDescricao` string, required
  - `ClienteIP` string
  - `ClienteCPFCNPJ` string, required
  - `ClienteNome` string, required
  - `ClienteEmail` string
  - `ClienteSexo` string
  - `ClienteDDD` string
  - `ClienteNumeroCelular` string
  - `ClienteEndereco` string
  - `ClienteComplemento` string
  - `ClienteNumero` string
  - `ClienteBairro` string
  - `ClienteCidade` string
  - `ClienteCEP` string
  - `ClienteUF` string
  - `NumeroPedido` string
  - `Referencia` string
  - `PreAutorizar` boolean
  - `AntiFraude` boolean

## Other responses

- `400`: Erro executando o método

## Changes

- **2026-11-03** `a8b4ea0aa298`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/meuk8/apis/k8-fintech/changes/api/PagueContas/EfetuarPagamento/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)