---
title: "Cria uma transação OpenFinance"
method: POST
path: "/api/CriaTransacaoOpenFinance"
tags: ["CriaTransacaoOpenFinance"]
---

# Cria uma transação OpenFinance

`POST /api/CriaTransacaoOpenFinance`

## Request

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

Este endpoint permite a criação de uma transação via OpenFinance.

### Requisição
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** |
|--|--|--|--|
| Valor | Numérico | Valor da compra | Sim |
| DataVencimento | Data | Data de vencimento da transação | Sim |
| URLConfirmacao | Texto | URL de confirmação do comércio para indicar que o pagamento está em estado final | 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 |
| ClienteEndereco | Texto | Endereço do cliente final da transação | Não |
| ClienteBairro | Texto | Bairro do cliente final da transação | Não |
| ClienteCidade | Texto | Cidade do cliente final da transação | Não |
| ClienteCEP | Texto | CEP do cliente final da transação | Não |
| ClienteUF | Texto | UF do cliente final da transação | Não |
| ClienteDDD | Texto |DDD do telefone do cliente final da transação | Não |
| ClienteNumeroCelular | Texto | Número do telefone do cliente final da transação | Não |
| NumeroPedido | Texto | Número do pedido para controles internos | Não |
| DataLimitePagamento | Data | Data limite para pagamento do título.Após esta data, o mesmo é baixado junto a CIP | Não |
            
### 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 gerada, caso chamada seja exitosa | 
| CodigoErro | Texto | Código do erro retornado| 
| Url | Texto | Url de retorno para OpenFinance |

## Headers

- `Aeskey` string, required

## Request body

- BknBankPagamentosBusinessCriaTransacaoOpenFinanceRequest
  - `Valor` number, double
  - `DataVencimento` 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
  - `DataLimitePagamento` string, date-time

## Response `200`

Método executado

- BknBankPagamentosBusinessCriaTransacaoOpenFinanceResponse
  - `Retorno` 'OK' | 'ERRO'
  - `DetalhesErro` string
  - `Identificador` string
  - `CodigoErro` string
  - `Url` string

## Changes

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

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