Criar Pedido com Autenticação Externa (MPI)

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.

Authorizations

X-Token-ApistringRequired

Body

startDatestring · dateOptional

Data de início da cobrança. Se não enviado, o startDate será a data atual

Example: 2025-08-06

valuenumber · decimal · min: 0.01Required

Valor da cobrança

Example: 130

installmentsinteger · min: 1 · max: 12Required

Número de parcelas

Example: 1

titlestring · max: 255Required

Título da cobrança

Example: Titulo da compra

Responses

201

Ordem criada com sucesso

application/json

uuidstring · uuidOptional

UUID da ordem

Example: 4668ab70-39c3-4ab3-8770-995f6333e200

statusstring · enumOptional

Status da ordem

Example: SENTPossible values:

titlestringOptional

Título da ordem

Example: Compra Exemplo

valuenumber · decimalOptional

Valor da ordem

Example: 130

installmentsintegerOptional

Número de parcelas

Example: 1

startDatestring · dateOptional

Data de início

Example: 2025-08-06

paymentstringOptional

Método de pagamento

Example: CREDIT_CARD_EARLY_SELLER

400

Requisição inválida

application/json

401

Não autorizado

application/json

403

Acesso proibido

application/json

500

Erro interno do servidor

application/json

post/v2/orders

POST /v2/orders HTTP/1.1
Host: api.barte.com
X-Token-Api: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 929

{
  "startDate": "2025-08-06",
  "value": 130,
  "installments": 1,
  "title": "Titulo da compra",
  "payment": {
    "method": "CREDIT_CARD_EARLY_SELLER",
    "card": {
      "cardToken": "efde9a25-76f9-4d0a-bfbc-1abbdbd8bc07",
      "cvv": "950"
    },
    "fraudData": {
      "internationalDocument": {
        "documentNumber": "04909778128",
        "documentType": "cpf",
        "documentNation": "BR"
      },
      "name": "João Silva",
      "email": "[e-mail]",
      "phone": "5511999994444",
      "billingAddress": {
        "country": "BR",
        "state": "Minas Gerais",
        "city": "Uberlândia",
        "district": "Centro",
        "street": "Rua Exemplo",
        "zipCode": "38411999",
        "number": "123",
        "complement": "Apto 45"
      }
    }
  },
  "threeDSecure": {
    "mpi": {
      "acsTransactionId": "9505fcb7-f983-1e4f-b4c3-74b01b8s49e2",
      "cavv": "AAIBBYNoEwAAACcKhAJkdQAAAAA=",
      "challenged": "true",
      "directoryServerTransactionId": "4e8531da-2a3e-4c9d-9d8c-3da3c2f7ed32",
      "eci": "05",
      "threeDSServerTransactionId": "4830a4b7-b80e-4bba-ddf3-d41699e771f0",
      "transStatus": "Y",
      "version": "2.2.0",
      "xid": "AAIBBYNoEwBBACdKkzJkdIAAA="
    }
  }
}

{
  "uuid": "4668ab70-39c3-4ab3-8770-995f6333e200",
  "status": "SENT",
  "title": "Compra Exemplo",
  "value": 130,
  "installments": 1,
  "startDate": "2025-08-06",
  "payment": "CREDIT_CARD_EARLY_SELLER"
}