Criar Pagamento

Criar pagamento

POST /v1/payments

Autoriza uma transação com cartão. Envie o numeroCartao OU um token de cartão previamente tokenizado (ver Tokenizar cartão).

Requer autenticação Bearer. Veja Autenticação.

Request

Body

{
  "identificacaoPagamento": "PAG-20250723-0001",
  "numeroParcelas": 3,
  "tipoParcelamento": "4",
  "bandeiraCartao": "1",
  "valor": 150.00,
  "dataExpiracao": "12/28",
  "codigoSeguranca": "123",
  "numeroCartao": "4111111111111111"
}

Campos

Campo	Tipo	Obrigatório	Descrição
`identificacaoPagamento`	string	sim	Identificação única do pagamento, gerada pelo sistema de origem
`numeroParcelas`	integer	sim	Número de parcelas (mínimo `1`)
`tipoParcelamento`	enum	sim	Tipo de parcelamento. Valores: `3`, `4`, `6`, `7`
`bandeiraCartao`	string	sim	Código numérico da bandeira do cartão (ex.: `1`)
`valor`	number	sim	Valor total da transação
`dataExpiracao`	string	não	Validade do cartão no formato `MM/AA` (ex.: `12/28`)
`codigoSeguranca`	string	não	CVV/CVC do cartão
`numeroCartao`	string	condicional	Número do cartão. Obrigatório quando não for pagamento via token
`token`	string	condicional	Token do cartão tokenizado. Obrigatório quando for pagamento via token (dispensa `numeroCartao`)

A lista completa de códigos de bandeiraCartao é extensa e é fornecida pelo time de Crédito. Utilize o código correspondente à bandeira do cartão usado na transação.

Response

`201 Created`

{
  "codigo": "0",
  "mensagem": "Transacao autorizada",
  "codigoAutorizacao": "00",
  "mensagemAutorizador": "Transacao aprovada",
  "status": "CON",
  "identificadorPagamento": "PAG-20250723-0001",
  "numeroAutorizacao": "123456",
  "valor": 150.00,
  "tipoPagamento": "C",
  "esitefUsn": "123456789012345",
  "dataPagamento": "23/07/2026T14:35"
}

Campos da resposta (principais)

Campo	Tipo	Descrição
`codigo`	string	Código de resposta. Diferente de `0` significa falha
`mensagem`	string	Mensagem de resposta. Diferente de `Transacao autorizada` significa falha
`status`	enum	Status da transação — ver Status de transação
`identificadorPagamento`	string	Código de pedido enviado na criação (order_id)
`numeroAutorizacao`	string	Número de autorização da transação
`valor`	number	Valor da transação
`tipoPagamento`	enum	`B` boleto, `C` crédito, `D` débito, `P` private label, `T` transferência, `G` gift, `O` outros, `W` boleto NR
`esitefUsn`	string	Número sequencial único da transação
`dataPagamento`	string	Data de efetivação no formato `DD/MM/AAAA'T'HH:mm`

Erros

Status	Significado
`400`	Requisição inválida (campos obrigatórios ausentes ou mal formatados)
`401`	Não autorizado
`500`	Erro interno ao processar o pagamento

Corpo de erro (ErrorResponse):

{
  "code": "VALIDATION_ERROR",
  "message": "Campos obrigatorios ausentes",
  "details": [{ "campo": "valor", "erro": "obrigatorio" }],
  "traceId": "a1b2c3d4",
  "timestamp": "2026-08-06T14:30:00Z"
}

Criar Pagamento

On this page