curl --request POST \
  --url https://sandbox.4seletpay.com.br/api/v2/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "BRL",
  "customer": {
    "name": "João Silva",
    "email": "joao@exemplo.com.br",
    "phone": {
      "ddi": "55",
      "ddd": "11",
      "number": "999999999"
    },
    "document": {
      "type": "cpf",
      "number": "12345678909"
    }
  },
  "payments": [
    {
      "type": "card",
      "amount": 10000,
      "capture_method": "manual",
      "card": {
        "number": "4111111111111111",
        "holder_name": "João Silva",
        "exp_month": "12",
        "exp_year": "2030",
        "cvc": "123",
        "installments": 1
      }
    }
  ],
  "items": [
    {
      "code": "SKU-1",
      "description": "Camiseta Premium",
      "quantity": 1,
      "amount": 10000
    }
  ],
  "metadata": {
    "pedido_loja": "1024"
  }
}
'

{
  "id": "ord_7Hk2Pq9Xm4Ln8Rt3",
  "object": "order",
  "status": "requires_capture",
  "currency": "brl",
  "amount": 10000,
  "original_amount": 10000,
  "original_currency": "brl",
  "payments": [
    {
      "id": "cha_8Kq2Lm9XvB3nT7pZ",
      "object": "payment_intent",
      "status": "requires_capture",
      "amount": 10000,
      "amount_refunded": 0,
      "currency": "brl",
      "original_amount": 10000,
      "original_currency": "brl",
      "exchange_rate": null,
      "payment_method_details": {
        "type": "card",
        "card": {
          "brand": "visa",
          "first_six": "411111",
          "last_four": "1111",
          "holder_name": "João Silva",
          "exp_month": 12,
          "exp_year": 2030
        }
      }
    }
  ],
  "next_action": null
}

Pedidos

Criar pedido

Cria um pedido com um ou mais pagamentos (payments), como um cartão, dois cartões ou cartão + PIX. A soma de items[].amount × items[].quantity precisa ser igual à soma de payments[].amount. Todos os valores são em centavos.

Captura. Um pagamento com cartão sem capture_method usa manual: o valor é autorizado e o pedido fica em requires_capture até você chamar POST /v2/orders/{id}/capture. Com capture_method: automatic, a venda é direta, mas só em pedidos com um único pagamento. Em pedidos com dois ou mais pagamentos, todo cartão é pré-autorizado. Em cartão + PIX, o cartão é capturado automaticamente quando o PIX é pago.

201 não significa pago. A resposta traz o resultado da autorização: requires_capture, requires_action (QR Code PIX ou verificação por código em next_action), processing (venda aceita, aguardando confirmação) ou failed (HTTP 402, com failure_reason). A confirmação do pagamento chega por webhook (order.paid, charge.paid).

Tudo ou nada. Se um dos pagamentos for recusado, os pagamentos já autorizados são desfeitos e o pedido falha.

PayPal. O PayPal processa apenas cobranças em BRL: um pedido com currency diferente de BRL processado por ele é recusado com 402, mesmo com a conversão para real, e failure_reason, não com erro de requisição. O PayPal nunca é escolhido para pedidos com dois ou mais pagamentos, porque não tem as capacidades exigidas por esse tipo de pedido. Se ele for a única adquirente da conta, esses pedidos retornam 422 acquirer_feature_not_supported.

POST

orders

curl --request POST \
  --url https://sandbox.4seletpay.com.br/api/v2/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "BRL",
  "customer": {
    "name": "João Silva",
    "email": "joao@exemplo.com.br",
    "phone": {
      "ddi": "55",
      "ddd": "11",
      "number": "999999999"
    },
    "document": {
      "type": "cpf",
      "number": "12345678909"
    }
  },
  "payments": [
    {
      "type": "card",
      "amount": 10000,
      "capture_method": "manual",
      "card": {
        "number": "4111111111111111",
        "holder_name": "João Silva",
        "exp_month": "12",
        "exp_year": "2030",
        "cvc": "123",
        "installments": 1
      }
    }
  ],
  "items": [
    {
      "code": "SKU-1",
      "description": "Camiseta Premium",
      "quantity": 1,
      "amount": 10000
    }
  ],
  "metadata": {
    "pedido_loja": "1024"
  }
}
'

{
  "id": "ord_7Hk2Pq9Xm4Ln8Rt3",
  "object": "order",
  "status": "requires_capture",
  "currency": "brl",
  "amount": 10000,
  "original_amount": 10000,
  "original_currency": "brl",
  "payments": [
    {
      "id": "cha_8Kq2Lm9XvB3nT7pZ",
      "object": "payment_intent",
      "status": "requires_capture",
      "amount": 10000,
      "amount_refunded": 0,
      "currency": "brl",
      "original_amount": 10000,
      "original_currency": "brl",
      "exchange_rate": null,
      "payment_method_details": {
        "type": "card",
        "card": {
          "brand": "visa",
          "first_six": "411111",
          "last_four": "1111",
          "holder_name": "João Silva",
          "exp_month": 12,
          "exp_year": 2030
        }
      }
    }
  ],
  "next_action": null
}

201 Created não significa pago. O pedido pode voltar em requires_capture, requires_action ou processing. A confirmação chega pelos webhooks order.paid e charge.paid. Um pagamento recusado responde 402, com o pedido completo e o motivo em failure_reason.

Envie um ou mais pagamentos em payments. Um pedido com vários pagamentos é tudo ou nada: se um for recusado, os demais são desfeitos.

Sem capture_method, um pagamento com cartão usa captura manual e o pedido fica em requires_capture até você chamar /capture. Com capture_method: "automatic", a venda é direta só quando o pedido tem um único pagamento. Em cartão + PIX, o cartão é capturado automaticamente quando o PIX é pago. Veja Captura.

Para cobrar um cartão salvo, envie card.token com o id do cartão no lugar dos dados do cartão.

A soma dos itens (amount × quantity) precisa ser igual à soma dos pagamentos. Com cartão no pedido, o pix_expiration pode ser de no máximo 86400 segundos. Pular a análise de fraude (fraud_analysis) exige permissão da conta.

Limite de 2 tentativas por minuto do mesmo comprador para os mesmos itens (429 rate_limit_exceeded). Envie o header Idempotency-Key para reenviar com segurança. Veja Idempotência e limites.

Authorizations

Authorization

string

header

required

Chave de API (secret key) da conta, no formato sk_live_... (produção) ou sk_test_... (Ambiente de Sandbox). Envie no header Authorization: Bearer <chave>. Autentica todas as rotas da API v2 e as rotas de Análise de Fraude. A chave identifica a conta, então a API v2 não usa o header account. Uma chave só é aceita no ambiente em que foi criada. Gere a sua no dashboard em Configurações → Chaves de API.

Headers

Idempotency-Key

string

Chave de idempotência opcional e recomendada. Tem até 128 caracteres e vale por 24 horas, por conta. A mesma chave com o mesmo corpo devolve a resposta original (mesmo status e mesmo corpo), sem processar de novo. Só respostas 2xx ficam guardadas: depois de um erro, a mesma chave pode ser reutilizada. A mesma chave com um corpo diferente retorna 422 (idempotency_key_conflict), uma requisição original ainda em andamento retorna 409 (idempotency_key_in_use) e uma chave com mais de 128 caracteres retorna 400 (idempotency_key_invalid).

Maximum string length: 128

Example:

"pedido-1024-tentativa-1"

Body

application/json

A soma de items[].amount × items[].quantity precisa ser igual à soma de payments[].amount. Todos os valores são em centavos.

customer

object

required

Dados do comprador. A API v2 não tem recurso de cliente: envie o comprador em cada requisição.

Show child attributes

payments

object[]

required

Um ou mais meios de pagamento. Todos são processados juntos, no mesmo pedido

Minimum array length: 1

Show child attributes

items

object[]

required

Minimum array length: 1

Show child attributes

currency

enum<string>

default:BRL

Moeda dos valores enviados (payments[].amount e items[].amount). A conversão para real acontece uma vez, na criação de cada pagamento, e a adquirente sempre recebe BRL. Não tem relação com international.

Available options:

BRL,

USD

international

boolean

default:false

Restringe a escolha às adquirentes habilitadas para compra internacional. Não tem relação com currency: uma cobrança em BRL pode ser internacional. Se nenhuma adquirente da conta atender, a resposta é 422 acquirer_feature_not_supported. Não é devolvido na resposta.

fraud_analysis

object

Pula a análise de fraude. Exige permissão da conta — sem ela, a requisição retorna 422 (fraud_bypass_not_allowed). Todo pulo precisa de um motivo, que fica registrado.

Show child attributes

metadata

object | null

Dados livres da sua integração

Example:

{ "pedido_loja": "1024" }

Response

Pedido criado. Confira o status: requires_capture (cartão autorizado, aguardando captura), requires_action (PIX aguardando pagamento ou verificação por código, veja next_action) ou processing (venda aceita, aguardando confirmação). 201 não significa pago.

Pedido. O status é a agregação dos seus pagamentos. processing: em processamento. requires_capture: cartão autorizado, aguardando captura. requires_action: PIX aguardando pagamento ou verificação por código (veja next_action). paid: pago. failed: recusado (veja failure_reason). canceled: cancelado. refunded e partially_refunded: estornado. chargeback: contestado.

string

Código do pedido

Example:

"ord_7Hk2Pq9Xm4Ln8Rt3"

object

enum<string>

Available options:

order

status

enum<string>

Available options:

processing,

requires_capture,

requires_action,

paid,

failed,

canceled,

refunded,

partially_refunded,

chargeback

currency

enum<string>

Sempre brl

Available options:

brl

Example:

"brl"

original_amount

integer

Valor total na moeda enviada, em centavos. Igual a amount em BRL

Example:

10000

original_currency

string

Moeda enviada, em minúsculas

Example:

"brl"

amount

integer

Valor total cobrado, em centavos de real (soma dos pagamentos)

Example:

10000

payments

object[]

Show child attributes

next_action

object | null

O que precisa acontecer para o pagamento seguir. pix_display_qr_code: exiba o QR Code para o pagador. otp_confirmation: a análise de fraude pediu verificação — nada é cobrado até o código ser confirmado na rota /confirm.

Show child attributes

failure_reason

object

Motivo da recusa. Presente só quando o status é failed

Show child attributes

Pedidos

Cobranças

Cartões

Assinaturas

Faturas

Contestações

Links de pagamento

Análise de fraude

Criar pedido

Authorizations

Headers

Body

Response