---
title: "Criar novo pedido com Cartão de Crédito"
method: POST
path: "/partners/api/v4/orders"
tags: ["Gerenciamento de Pedidos"]
---

# Criar novo pedido com Cartão de Crédito

`POST /partners/api/v4/orders`

Cria um novo pedido com pagamento via **Cartão de Crédito**, incluindo validação, antifraude e processamento do pagamento. O retorno 201 pode ser `completed` (aprovado) ou `pending` (processamento/3DS/análise).

## Request body

- CreateOrderRequestDto
  - `client` ClientDto, required
    - `clientVersion` 'v1', required — Versão do cliente
  - `customer` CustomerDto, required
    - `id` number, required — ID do cliente
    - `email` string, required — Email do cliente
    - `name` string, required — Nome do cliente
    - `phone` string, required — Telefone do cliente
    - `documentType` string, required — Tipo do documento
    - `documentNumber` string, required — Número do documento
    - `birthDate` string — Data de nascimento
    - `gender` string — Gênero
    - `newsletterSubscription` boolean — Inscrição na newsletter
  - `device` DeviceDto, required
    - `id` string, required — Identificador único do dispositivo
  - `orderItems` OrderItemDto[], required — Lista de itens do pedido
    - `type` 'ticket' | 'insurance', required — Tipo do item
    - `isLowFare` boolean, required — Indica se é uma ClickOferta
    - `meta` OrderItemMetaDto, required
      - `id` string, required — Identificador único do assento bloqueado
      - `amount` number, float, required — Valor do item
      - `tripTypeDirection` 'departure_type' | 'return_type' — Direção da viagem (Só é obrigatório se o item for do tipo ticket)
      - `type` 'direct' | 'one_stop' | 'connection' — Tipo da viagem (Só é obrigatório se o item for do tipo ticket)
      - `tripLeg` integer — Número da perna da viagem (Só é obrigatório se o item for do tipo ticket e a viagem for connection)
      - `passenger` PassengerDto, required
        - `documentType` 'cpf' | 'rg' | 'passport' | 'cnh', required — Tipo do documento do passageiro
        - `documentNumber` string, required — Número do documento do passageiro
        - `name` string, required — Nome completo do passageiro
  - `payment` PaymentDto, required
    - `amount` number, float, required — Valor do pagamento
    - `currency` 'BRL', required — Moeda do pagamento
    - `installments` integer, required — Número de parcelas
    - `paymentDetails` PaymentDetailsDto, required — Detalhes específicos do pagamento (pode ser vazio)
    - `meta` PaymentMetaDto, required — Metadados do pagamento (pode ser vazio)
    - `type` 'direct' | 'credit_card', required — Tipo de pagamento (direct para pagamento faturado, credit_card para cartão de crédito)
  - `totalAmount` number, double, required — Valor total do pedido
  - `externalId` string — Identificador do pedido no sistema do parceiro (opcional)

## Response `201`

Pedido criado com sucesso (pode estar `completed` ou em análise `pending`)

- CreateOrderResponseDto
  - `orderId` string, required — Identificador único do pedido criado
  - `status` string, required — Status do pedido
  - `totalAmount` number, float, required — Valor total do pedido
  - `createdAt` string, date-time, required — Data e hora de criação do pedido
  - `externalOrderId` string — Identificador do pedido no sistema do parceiro (se fornecido)
  - `paymentStatus` string, required — Status do pagamento
  - `itemDetails` ItemDto, required
    - `id` number, required — ID do item
    - `type` string, required — Tipo do item
    - `status` string, required — Status do item
    - `amount` string, required — Valor do item
    - `currency` string, required — Moeda do item
    - `createdAt` string, required — Data de criação
    - `updatedAt` string, required — Data de atualização
    - `itemDetails` object, required — Detalhes específicos do item
      - `trip` object — Informações da viagem
        - `id` string
        - `type` string
        - `departure` object
          - `schedule` object
            - `date` string
            - `time` string
            - `timezone` string
          - `place` object
            - `id` number
            - `name` string
            - `slug` string
            - `city` string
            - `state` string
            - `country` string
            - `terminal` string
        - `arrival` object
          - `schedule` object
            - `date` string
            - `time` string
            - `timezone` string
          - `place` object
            - `id` number
            - `name` string
            - `slug` string
            - `city` string
            - `state` string
            - `country` string
            - `terminal` string
        - `serviceClass` object
          - `id` number
          - `name` string
        - `travelCompany` object
          - `id` number
          - `name` string
          - `logo` string
          - `slug` string
        - `duration` string
        - `busName` string
        - `availableSeats` number
        - `hasBoardingPass` boolean
        - `hasElectronicBoardingPass` boolean
      - `passenger` object — Informações do passageiro
        - `id` number
        - `name` string
        - `documentType` string
        - `documentNumber` string
        - `phone` string
        - `email` string
        - `birthDate` string
        - `gender` string
        - `seat` object
          - `id` number
          - `label` string
          - `position` object
            - `x` number
            - `y` number
            - `z` number
    - `actions` object, required — Ações disponíveis para o item
      - `canCancel` boolean
      - `canChange` boolean
      - `canRefund` boolean
      - `cancellationDeadline` string
      - `changeDeadline` string
    - `isLowFare` boolean, required — Se é um item Low Fare

## Other responses

- `400` — Requisição inválida ou erro de validação/antifraude (ex: falha 3DS - Status Code 200/400 retornado pelo endpoint de agregação, mas erro lógico na resposta `data`)
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/clickbus/apis/documenta-o-da-api-de-autentica-o-clickbus.md) · [All operations](https://skmtc.net/clickbus/apis/documenta-o-da-api-de-autentica-o-clickbus/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clickbus/documenta-o-da-api-de-autentica-o-clickbus/versions/ead7d81fdb28/schema)