curl --request POST \
  --url https://sandbox.4seletpay.com.br/api/v1/charge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'account: <account>' \
  --data '
{
  "international": false,
  "client": {
    "name": "João Silva",
    "email": "joao@exemplo.com.br",
    "gender": "Male",
    "birthdate": "1990-01-15",
    "phone": {
      "ddi": "55",
      "ddd": "11",
      "number": "999999999"
    },
    "document": {
      "type": "CPF",
      "number": "123.456.789-09"
    },
    "address": {
      "zipcode": "01310-100",
      "street": "Avenida Paulista",
      "number": 1000,
      "neighborhood": "Bela Vista",
      "complement": "Apto 42",
      "city": "São Paulo",
      "state": "SP",
      "country": "Brasil"
    }
  },
  "payment": {
    "type": "CreditCard",
    "card": {
      "number": "4111111111111111",
      "name": "JOAO SILVA",
      "month": "12",
      "year": "27",
      "security_code": "123",
      "installments": 1,
      "soft_descriptor": "MINHA LOJA"
    }
  },
  "items": [
    {
      "id": "produto_001",
      "description": "Camiseta Premium",
      "amount": 99.9,
      "quantity": 2
    }
  ]
}
'

{
  "mensagem": "Cobrança realizada com sucesso.",
  "erro": false,
  "mensagenserro": [],
  "codigoretorno": 201,
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "data": {
    "charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "charge_created_at": "11/03/2026 10:00:00",
    "account_id": 1,
    "code": "pur_abc123xyz",
    "value": 199.8,
    "charge_value": 199.8,
    "coin": "BRL",
    "status": "Approved",
    "client": {
      "code": "cli_abc123",
      "name": "João Silva",
      "email": "joao@exemplo.com.br"
    },
    "orders": [
      {
        "code": "ord_abc123xyz",
        "status": "Approved",
        "value": 199.8,
        "charges": [
          {
            "code": "chg_abc123",
            "status": "Approved",
            "value": 199.8,
            "installments": 1,
            "payment": {
              "payment_type": "CreditCard",
              "installments": 1,
              "card_token": "9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f"
            }
          }
        ]
      }
    ]
  }
}

{
  "mensagem": "A transação necessita de confirmação...",
  "erro": false,
  "mensagenserro": [],
  "codigoretorno": 202,
  "id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "Challenged",
    "orders": [
      {
        "code": "ord_abc123xyz",
        "status": "Challenged",
        "confirmation_codes": [
          {
            "id": "conf_xyz789",
            "type": "OTP",
            "status": "Pending",
            "expires_at": "2026-03-11T10:15:00.000000Z"
          }
        ]
      }
    ]
  }
}

{
  "mensagem": "Não foi possível concluir sua transação.",
  "erro": true,
  "mensagenserro": [
    "Verifique as informações e tente novamente."
  ],
  "codigoretorno": 400,
  "id": "00000000-0000-0000-0000-000000000000",
  "data": []
}

{
  "mensagem": "Unauthenticated.",
  "erro": true,
  "mensagenserro": [],
  "codigoretorno": 401,
  "id": "00000000-0000-0000-0000-000000000000",
  "data": []
}

{
  "message": "The given data was invalid.",
  "errors": {
    "client.email": [
      "O campo client.email é obrigatório."
    ]
  }
}

{
  "mensagem": "Um erro aconteceu.",
  "erro": true,
  "mensagenserro": [
    "Erro interno. Tente novamente mais tarde."
  ],
  "codigoretorno": 500,
  "id": "00000000-0000-0000-0000-000000000000",
  "data": []
}

Cobranças

Criar Cobrança

Cria uma nova cobrança (pedido de pagamento). Suporta os métodos de pagamento: CreditCard, PIX. Requer o header account com o código da conta. Passa por validações de fraude, bloqueio de clientes e rate limiting.

Possíveis cenários de resposta:

201 — Cobrança processada com sucesso (aprovada ou aguardando pagamento PIX)
202 — Transação desafiada (requer confirmação adicional via OTP)
400 — Fraude detectada ou erro no processamento do gateway
422 — Erro de validação dos dados enviados

POST

charge

curl --request POST \
  --url https://sandbox.4seletpay.com.br/api/v1/charge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'account: <account>' \
  --data '
{
  "international": false,
  "client": {
    "name": "João Silva",
    "email": "joao@exemplo.com.br",
    "gender": "Male",
    "birthdate": "1990-01-15",
    "phone": {
      "ddi": "55",
      "ddd": "11",
      "number": "999999999"
    },
    "document": {
      "type": "CPF",
      "number": "123.456.789-09"
    },
    "address": {
      "zipcode": "01310-100",
      "street": "Avenida Paulista",
      "number": 1000,
      "neighborhood": "Bela Vista",
      "complement": "Apto 42",
      "city": "São Paulo",
      "state": "SP",
      "country": "Brasil"
    }
  },
  "payment": {
    "type": "CreditCard",
    "card": {
      "number": "4111111111111111",
      "name": "JOAO SILVA",
      "month": "12",
      "year": "27",
      "security_code": "123",
      "installments": 1,
      "soft_descriptor": "MINHA LOJA"
    }
  },
  "items": [
    {
      "id": "produto_001",
      "description": "Camiseta Premium",
      "amount": 99.9,
      "quantity": 2
    }
  ]
}
'

{
  "mensagem": "Cobrança realizada com sucesso.",
  "erro": false,
  "mensagenserro": [],
  "codigoretorno": 201,
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "data": {
    "charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "charge_created_at": "11/03/2026 10:00:00",
    "account_id": 1,
    "code": "pur_abc123xyz",
    "value": 199.8,
    "charge_value": 199.8,
    "coin": "BRL",
    "status": "Approved",
    "client": {
      "code": "cli_abc123",
      "name": "João Silva",
      "email": "joao@exemplo.com.br"
    },
    "orders": [
      {
        "code": "ord_abc123xyz",
        "status": "Approved",
        "value": 199.8,
        "charges": [
          {
            "code": "chg_abc123",
            "status": "Approved",
            "value": 199.8,
            "installments": 1,
            "payment": {
              "payment_type": "CreditCard",
              "installments": 1,
              "card_token": "9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f"
            }
          }
        ]
      }
    ]
  }
}

{
  "mensagem": "A transação necessita de confirmação...",
  "erro": false,
  "mensagenserro": [],
  "codigoretorno": 202,
  "id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "Challenged",
    "orders": [
      {
        "code": "ord_abc123xyz",
        "status": "Challenged",
        "confirmation_codes": [
          {
            "id": "conf_xyz789",
            "type": "OTP",
            "status": "Pending",
            "expires_at": "2026-03-11T10:15:00.000000Z"
          }
        ]
      }
    ]
  }
}

{
  "mensagem": "Não foi possível concluir sua transação.",
  "erro": true,
  "mensagenserro": [
    "Verifique as informações e tente novamente."
  ],
  "codigoretorno": 400,
  "id": "00000000-0000-0000-0000-000000000000",
  "data": []
}

{
  "mensagem": "Unauthenticated.",
  "erro": true,
  "mensagenserro": [],
  "codigoretorno": 401,
  "id": "00000000-0000-0000-0000-000000000000",
  "data": []
}

{
  "message": "The given data was invalid.",
  "errors": {
    "client.email": [
      "O campo client.email é obrigatório."
    ]
  }
}

{
  "mensagem": "Um erro aconteceu.",
  "erro": true,
  "mensagenserro": [
    "Erro interno. Tente novamente mais tarde."
  ],
  "codigoretorno": 500,
  "id": "00000000-0000-0000-0000-000000000000",
  "data": []
}

Requer o header account com o código da conta. Passa por validações de fraude, bloqueio de clientes e rate limiting por cliente.

Clientes bloqueados por IP, e-mail, CPF ou BIN do cartão terão a cobrança rejeitada automaticamente.

Para cobrar um cartão já salvo, envie apenas payment.card.card_token (o token retornado ao salvar o cartão / no evento card.token_created) no lugar dos dados completos do cartão. Continue enviando payment.card.installments. O card_token só é aceito para cartões da mesma conta da cobrança.

O billing address do cartão não é tokenizado. Ao cobrar com card_token, informe o billing address (client.address) na própria requisição.

Authorizations

Authorization

string

header

required

Token JWT obtido via POST /v1/login. Envie no header Authorization: Bearer <token>.

Headers

account

string

required

Código da conta à qual a operação se aplica

Example:

"acc_abc123xyz"

Body

application/json

client

object

required

Show child attributes

payment

object

required

Show child attributes

items

object[]

required

Lista de itens da compra (obrigatório, mín. 1 item)

Show child attributes

Example:

[
  {
    "id": "produto_001",
    "description": "Camiseta Premium",
    "amount": 99.9,
    "quantity": 2
  }
]

international

boolean | null

Indica se é uma transação internacional (opcional, padrão false)

Example:

false

Response

Cobrança processada com sucesso

Resposta da criação de cobrança (envelope APIReturnUtil + dados ConsultCharge)

mensagem

string

Example:

"Cobrança realizada com sucesso."

erro

boolean

Example:

false

mensagenserro

string[]

Example:

[]

codigoretorno

integer

Example:

201

string

ID da cobrança criada

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

data

object

Dados completos de uma cobrança retornados pelo ConsultCharge

Show child attributes

Autenticação

Cobranças

Pedidos

Cartões

Assinaturas

Faturas

Links de Pagamento

Análise de Fraude

Webhooks

Criar Cobrança

Authorizations

Headers

Body

Response