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

# Criar Pagamento com MPI Externo

`POST /v2/orders`

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/v2/orders`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/v2/orders/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)