---
title: "Criar Pagamento com MPI Externo"
method: POST
path: "/v2/orders"
tags: ["MPI - Autenticação Externa"]
---

# Criar Pagamento com MPI Externo

`POST /v2/orders`

Cria uma cobrança usando autenticação externa (MPI). Utilize quando já possui os dados de autenticação 3DS de um provedor externo.

## Request body

- CreateOrderWithMPIRequest
  - `startDate` string, date — Data de início da cobrança. Se não enviado, o startDate será a data atual
  - `value` number, required — Valor da cobrança
  - `installments` integer, required — Número de parcelas
  - `title` string, required — Título da cobrança
  - `payment` PaymentMPIRequest, required
    - `method` 'CREDIT_CARD_EARLY_SELLER', required — Método de pagamento
    - `card` object, required
      - `cardToken` string, uuid, required — Token do cartão
      - `cvv` string, required — Código de segurança do cartão
    - `fraudData` FraudDataRequest, required
      - `internationalDocument` DocumentRequest
        - `documentNumber` string, required — Número do documento
        - `documentType` 'cpf' | 'cnpj', required — Tipo do documento
        - `documentNation` string, required — País do documento
      - `name` string — Nome do portador do cartão
      - `email` string, email — Email do portador do cartão
      - `phone` string — Telefone do portador do cartão
      - `billingAddress` BillingAddressRequest
        - `country` string, required — País
        - `state` string, required — Estado
        - `city` string, required — Cidade
        - `district` string, required — Bairro
        - `street` string, required — Rua
        - `zipCode` string, required — CEP
        - `number` string, required — Número
        - `complement` string — Complemento
  - `threeDSecure` ThreeDSecureMPIRequest, required
    - `mpi` MPIDataRequest, required
      - `acsTransactionId` string, required — ID da transação ACS
      - `cavv` string, required — Cardholder Authentication Verification Value
      - `challenged` string, required — Indica se houve desafio
      - `directoryServerTransactionId` string, required — ID da transação do Directory Server
      - `eci` string, required — Electronic Commerce Indicator
      - `threeDSServerTransactionId` string, required — ID da transação do 3DS Server
      - `transStatus` string, required — Status da transação
      - `version` string, required — Versão do 3DS
      - `xid` string, required — Transaction identifier

## Response `201`

Ordem criada com sucesso

- OrderResponse
  - `uuid` string, uuid — UUID da ordem
  - `status` 'SENT' | 'APPROVED' | 'DECLINED' | 'PENDING' — Status da ordem
  - `title` string — Título da ordem
  - `value` number — Valor da ordem
  - `installments` integer — Número de parcelas
  - `startDate` string, date — Data de início
  - `payment` string — Método de pagamento

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso proibido
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada.md) · [All operations](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/barte/api-de-sellers-v2-atualizada/versions/f0dd55b167f1/schema)