Skip to main content
POST
/
v1
/
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
            }
          }
        ]
      }
    ]
  }
}
{
  "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.

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
​
payment
object
required
​
items
object[]
required

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

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

​
id
string

ID da cobrança criada

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
data
object

Dados completos de uma cobrança retornados pelo ConsultCharge