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"
    },
    "conveniencefee": 0,
    "conveniencefeeamount": 0
  },
  "items": [
    {
      "id": "produto_001",
      "description": "Camiseta Premium",
      "amount": 99.9,
      "quantity": 2
    }
  ],
  "type": "PurchaseOrder",
  "cycletype": "Only"
}
'
{
  "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,
    "type": "PurchaseOrder",
    "cycle_type": "Only",
    "cycle": 1,
    "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
            }
          }
        ]
      }
    ]
  }
}
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

​
type
enum<string>

Tipo da compra (opcional)

Available options:
PurchaseOrder,
PlannedPurchaseOrder,
GeneralPurchaseOrder,
ContractualPurchaseOrder
Example:

"PurchaseOrder"

​
cycletype
enum<string>

Tipo de ciclo da compra (opcional)

Available options:
Only,
MonthlyRecurring,
QuarterlyRecurring,
SemiannualRecurring,
AnnualRecurring
Example:

"Only"

​
payment_source
object

Dados adicionais de origem do pagamento (usado para PayPal)

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