---
title: "Cria uma transação com pagamentos através de múltiplos cartões de crédito"
method: POST
path: "/api/CriaTransacaoCartoes"
tags: ["CriaTransacaoCartoes"]
---

# Cria uma transação com pagamentos através de múltiplos cartões de crédito

`POST /api/CriaTransacaoCartoes`

Este método permite criar uma transação com pagamento através de 2 cartões de crédito.
<br />

Basicamente o fluxo do processo é o mesmo de uma transação de cartão de crédito, porém com o diferencial de que neste processo serão geradas duas transações independentes porém com valores ligados ao total da transação.
<br /> 

**Importante:** a requisição não possui o total da transação mas sim as partes competentes à cada cartão utilizado, portanto em uma transação de R$ 500 poderá ser dividido por exemplo em Valor1: 350 e Valor2: 150.
<br />

Cabe ao criador da requisição definir valores e parcelas por cartão. 
<br /> 
As regras de negócio são as mesmas de uma transação comum, ou seja, dados do cartão são validados e vão seguir todo o fluxo de autorização da adquirente. Caso ocorra falhas no processo (falta de saldo, autorização negada, erros operacionais da bandeira, etc…) o conjunto das transações é automaticamente cancelado.
<br /> 

Caso erros ocorram na segunda transação, considerando que a primeira ocorreu com sucesso, automaticamente será feito o estorno da primeira transação. Além disso a resposta retornada para a requisição é composta necessariamente de duas partes, uma para cada cartão
<br /> 

### Requisição
| **Campo** | **Tipo** | **Descrição** | **Obrigatório**|
|--|--|--|--|
| NomeImpresso(1/2) | Texto | Nome do cliente impresso no cartão | Sim|
| DataValidade(1/2) | Ano/Mês no formato AAAAMM | Data de validade do cartão | Sim|
| NumeroCartao(1/2) | Numérico de até 16 posições |Número do cartão | Sim|
| CodigoSeguranca(1/2) | Numérico de até 4 posições | Código de segurança no verso do cartão | Sim|
| Valor(1/2) | Numérico com 2 decimais | Valor da compra à ser pago | Sim|
| QuantidadeParcelas(1/2) | Numérico 2 posições | Quantidade de parcelas, caso a forma de pagamento seja parcelada.Válidos valores de 2 até 12. Caso seja à vista, pode-se não enviar o valor ou enviar 0 ou 1 | Não|
| CardToken(1/2) | Guid | O token do cartão para transações de recorrência | Não|
| CartaoFormaPagamento | Numérico - Inteiro (1 posição) |Forma de pagamento do cartão, sendo possível os valores: 0 = À vista; 1 = Parcelado sem juros; 2 = Parcelado com juros| 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, podendo ser M (masculino) ou F (feminino) |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| 
| ClienteEndereco | Texto | Endereço do cliente final da transação | 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 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| 
| NumeroPedido | Texto | Número do pedido para controles internos | Não|
 
### Resposta
| **Campo** | **Tipo** | **Descrição** | 
|--|--|--| 
| Retorno | Texto | Retorno da chamada, podendo possuir os valores OK, ERRO, PENDENTEANTIFRAUDE ou CARTAOPREAUTORIZADO | 
|DetalhesErro  | Texto | Detalhes do erro gerado, caso o retorno seja ERRO | 
| Identificador1 |Texto  | Identificador da transação | 
| CodigoAutorizacao1 | Texto |Código de autorização da transação | 
| NsuOperacao1 | Texto | Código de NSU da transação | 
| NumeroAutorizacao1 | Texto | Número de autorização da transação | 
| Adquirente1 | Texto | Adquirente responsável pelo processamento da transação | 
| Bandeira1  | Texto | Bandeira do Cartão  | 
| Identificador2 | Texto | Identificador da transação | 
| CodigoAutorizacao2 | Texto | Código de autorização da transação | 
| NsuOperacao2 | Texto | Código de NSU da transação | 
| NumeroAutorizacao2 | Texto | Número de autorização da transação | 
| Adquirente2 | Texto | Adquirente responsável pelo processamento da transação | 
| Bandeira2  | Texto | Bandeira do Cartão  |

## Headers

- `Aeskey` string, required

## Request body

- BknBankPagamentosBusinessCriaTransacaoCartoesRequest
  - `NomeImpresso1` string
  - `DataValidade1` string
  - `NumeroCartao1` string
  - `CodigoSeguranca1` string
  - `Valor1` number, double
  - `QuantidadeParcelas1` integer
  - `CardToken1` string, uuid
  - `NomeImpresso2` string
  - `DataValidade2` string
  - `NumeroCartao2` string
  - `CodigoSeguranca2` string
  - `Valor2` number, double
  - `QuantidadeParcelas2` integer
  - `CardToken2` string, uuid
  - `CartaoFormaPagamento` 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
  - `PreAutorizar` boolean
  - `AntiFraude` boolean

## Response `200`

Método executado com sucesso

- BknBankPagamentosBusinessCriaTransacaoCartoesResponse
  - `Retorno` 'OK' | 'ERRO'
  - `DetalhesErro` string
  - `Identificador1` string
  - `CodigoAutorizacao1` string
  - `NsuOperacao1` string
  - `NumeroAutorizacao1` string
  - `Adquirente1` string
  - `Bandeira1` string
  - `Identificador2` string
  - `CodigoAutorizacao2` string
  - `NsuOperacao2` string
  - `NumeroAutorizacao2` string
  - `Adquirente2` string
  - `Bandeira2` string

## Other responses

- `500` — Erro executando método

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)