Criar transação

POSThttps://{apiUrl}/transactions

Atualizado em 16 de dezembro de 2025 · 3 min de leitura

Para criar uma transação, use a rota /transactions, tanto para cartão de crédito, boleto ou PIX.

Endpoint: POST https://{apiUrl}/transactions

Cria uma nova transação de pagamento. Suporta cartão de crédito (com parcelamento), boleto bancário e PIX.

Parâmetros principais

POSThttps://{apiUrl}/transactions

URL base da API

Token de autenticação

Body Params

customerobjectrequired

Dados do cliente (name, email, document, document_type, mobile_phone)

itemsarrayrequired

Lista de itens (description, price em centavos, quantity)

totalfloatrequired

Valor total em reais

payment_methodstringrequired

"credit_card", "boleto" ou "pix"

installmentsintegeroptional

Número de parcelas (somente cartão de crédito)

capturebooleanoptional

false para pré-autorização (default: true)

postbackUrlstringoptional

URL para notificações de status da transação

curl --request POST \
  --url "https://{apiUrl}/transactions" \
  --header "Content-Type: application/json" 
  --data '{}'

Response

Choose an example:

application/json

Responses

Cartões para testes em Sandbox

Número do Cartão	Bandeira	Status	Descrição
`4012 8888 8888 1881`	Visa	`not_authorized`	Transação não autorizada pelo banco emissor

Para qualquer outro número de cartão válido no sandbox, a transação será aprovada (paid).

Idempotência

Para evitar cobranças duplicadas em caso de timeout, use o header X-Idempotency-Key com um UUID único por tentativa.

X-Idempotency-Key: {uuid-unico}

Exemplo de requisição

curl --request POST \
  --url "https://{apiUrl}/transactions" \
  --header "Authorization: Bearer {token}" \
  --header "Content-Type: application/json" \
  --data '{
    "customer": {
      "name": "João da Silva",
      "email": "joao@exemplo.com",
      "document": "11111111111",
      "document_type": "CPF",
      "mobile_phone": "48999999999"
    },
    "items": [{ "description": "Produto", "price": 10000, "quantity": 1 }],
    "total": 100.00,
    "payment_method": "credit_card",
    "installments": 1
  }'

Esta página foi útil?