Skip to main content
POST
/
v1
/
charge
curl --request POST \ --url https://hml.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
            }
          }
        ]
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.4seletpay.com.br/llms.txt

Use this file to discover all available pages before exploring further.

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