Criar Pedido com 3DS

Criar Pagamento com 3DS

post

https://api.barte.comhttps://sandbox-api.barte.com

/v2/orders

Cria uma cobrança utilizando 3DS2. O objeto threeDSecure é obrigatório para transações 3DS. ⚠️ IMPORTANTE: Caso a transação retorne como pendente (challenged = true), será necessário implementar um fluxo assíncrono com Step Up Challenge e polling para verificar o status final.

Authorizations

X-Token-Api

X-Token-ApistringRequired

Header parameters

x-idempotency-keystring · uuidRequired

Chave de idempotência para evitar duplicação de transações

Body

application/json

startDatestring · dateRequired

Data de início da cobrança

Example: 2025-04-16

valuenumber · decimal · min: 0.01Required

Valor da cobrança

Example: 130

installmentsinteger · min: 1 · max: 12Required

Número de parcelas

Example: 3

urlCallBackstring · uriOptional

URL de callback para notificações

Example: https://webhook.site/unique-id

titlestring · max: 255Required

Título da cobrança

Example: Compra Exemplo

descriptionstring · max: 500Optional

Descrição da cobrança

Example: Descrição da compra

uuidBuyerstring · uuidRequired

UUID do comprador

Example: 71d12215-267a-4620-9b17-0715c84d23bd

Responses

201

Ordem criada com sucesso

application/json

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

HTTPcURLJavaScriptPython

POST /v2/orders HTTP/1.1
Host: api.barte.com
X-Token-Api: YOUR_API_KEY
x-idempotency-key: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 1573

{
  "startDate": "2025-04-16",
  "value": 130,
  "installments": 3,
  "urlCallBack": "https://webhook.site/unique-id",
  "title": "Compra Exemplo",
  "description": "Descrição 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": "[email protected]",
      "phone": "5511999994444",
      "billingAddress": {
        "country": "BR",
        "state": "MG",
        "city": "Uberlândia",
        "district": "Centro",
        "street": "Rua Exemplo",
        "zipCode": "38411999",
        "number": "123",
        "complement": "Apto 45"
      }
    }
  },
  "threeDSecure": {
    "dataOnly": false,
    "requiresLiabilityShift": false,
    "setupId": "e453da0b-b6a1-4c9a-8820-f2da23b3ffb7",
    "redirectURL": "http://localhost:3000/checkout.html",
    "requestorURL": "http://localhost:3000",
    "browser": {
      "ip": "127.0.0.1",
      "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36",
      "acceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
      "language": "pt-BR",
      "colorDepth": 24,
      "screenHeight": 1080,
      "screenWidth": 1920,
      "timeZoneOffset": "-180",
      "javaEnabled": false,
      "javaScriptEnabled": true
    },
    "billingAddress": {
      "city": "Uberlândia",
      "country": "BR",
      "streetNumber": "123",
      "zipCode": "38411999",
      "state": "MG",
      "street": "Rua Exemplo"
    },
    "shippingAddress": {
      "city": "Uberlândia",
      "country": "BR",
      "streetNumber": "123",
      "zipCode": "38411999",
      "state": "MG",
      "street": "Rua Exemplo"
    },
    "cardHolder": {
      "email": "[email protected]",
      "mobilePhone": "24999329393"
    }
  },
  "uuidBuyer": "71d12215-267a-4620-9b17-0715c84d23bd"
}

{
  "uuid": "4668ab70-39c3-4ab3-8770-995f6333e200",
  "status": "SENT",
  "title": "Compra Exemplo",
  "description": "Descrição da compra",
  "value": 130,
  "installments": 3,
  "startDate": "2025-04-16",
  "payment": "CREDIT_CARD_EARLY_SELLER",
  "customer": {
    "document": "89259815053",
    "type": "CPF",
    "documentCountry": "BR",
    "name": "João Silva",
    "email": "[email protected]",
    "phone": "11948256898",
    "alternativeEmail": "[email protected]",
    "integrationCustomerId": "91e89dc6-5226-47f3-a8b8-f8a2009c669e"
  },
  "idempotencyKey": "5e643a79-3b3f-4db9-95a3-a998caf914ff",
  "subSellerPaymentResponse": [
    {}
  ],
  "charges": [
    {
      "uuid": "27dccdbb-73a9-4799-93c9-e30e2c71cc75",
      "title": "Compra Exemplo",
      "expirationDate": "2025-04-16",
      "value": 130,
      "paymentMethod": "CREDIT_CARD_EARLY_SELLER",
      "status": "SCHEDULED",
      "customer": {
        "document": "89259815053",
        "type": "CPF",
        "name": "João Silva",
        "email": "[email protected]",
        "phone": "11948256898",
        "alternativeEmail": "[email protected]"
      }
    }
  ],
  "threeDSResponse": {
    "dataOnly": false,
    "requiresLiabilityShift": false,
    "redirectURL": "http://localhost:3000/checkout.html",
    "browser": {
      "ip": "127.0.0.1",
      "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36",
      "acceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
      "language": "pt-BR",
      "screenHeight": 1080,
      "screenWidth": 1920,
      "javaEnabled": false,
      "javaScriptEnabled": true
    },
    "auth": {
      "action": "REDIRECT",
      "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
      "stepUrl": "https://centinelapistag.cardinalcommerce.com/V2/Cruise/StepUp"
    },
    "challenged": true,
    "authenticated": false,
    "offeredType": "Challenge",
    "liabilityShift": false
  }
}