---
title: "Criar transação de pagamento"
method: POST
path: "/v1/payment-transaction/create"
---

# Criar transação de pagamento

`POST /v1/payment-transaction/create`

Cria uma nova transação de pagamento com cartão, boleto ou PIX.

## Request body

- object
  - `amount` integer, required — Total amount in cents
  - `payment_method` 'pix' | 'credit_card' | 'boleto', required
  - `postback_url` string, required — URL Para receber atualizações da transação
  - `customer` object, required
    - `name` string, required
    - `email` string, required
    - `document` object, required
      - `number` string, required
      - `type` 'cpf' | 'cnpj', required
    - `phone` string, required
  - `items` object[], required
    - `title` string, required
    - `unit_price` integer, required
    - `quantity` integer, required
    - `tangible` boolean, required — Define se o produto é físico ou não
    - `external_ref` string
  - `shipping` object
    - `fee` number
    - `address` object
      - `street` string
      - `street_number` string
      - `complement` string
      - `zip_code` string
      - `neighborhood` string
      - `city` string
      - `state` string
      - `country` string
  - `pix` object
    - `expires_in_days` integer, required
  - `card` object
    - `hash` string
    - `number` string, required
    - `holder_name` string, required
    - `expiration_month` integer, required
    - `expiration_year` integer, required
    - `cvv` string, required
  - `boleto` object
    - `expires_in_days` integer, required
  - `installments` integer
  - `metadata` string, json, required — Ex: { "provider_name": "Nome da label" }
  - `ip` string
  - `split` object[]
    - `company_id` string, required — Encontrado na tela Credenciais API
    - `fixed_amount` integer — Valor fixo (Em centavos) Exemplo: 500 = R$ 5,00
    - `percentage` integer — Valor percentual Exemplo: 20 = 20%

## Response `200`

Transação criada com sucesso

- object
  - `data` object[]
    - `id` string
    - `amount` integer
    - `installments` integer
    - `payment_method` string
    - `status` 'PENDING' | 'PAID' | 'REFUNDED' | 'REFUSED' | 'CHARGEBACK' | 'PRECHARGEBACK' | 'EXPIRED' | 'ERROR'
    - `postback_url` string
    - `card` object[]
      - `hash` string
      - `number` string
      - `holder_name` string
      - `expiration_month` integer
      - `expiration_year` integer
      - `cvv` string
    - `boleto` object[]
      - `expires_in_days` integer
    - `pix` object[]
      - `expiration_date` string, date-time
      - `qr_code` string
      - `url` string
      - `e2_e` string

## Other responses

- `400` — Erro de validação
- `401` — Falha na autenticação
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/freepaybrasil/apis/slimpay-api.md) · [All operations](https://skmtc.net/freepaybrasil/apis/slimpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freepaybrasil/slimpay-api/versions/4e380aa22c6f/schema)