Skip to main content
POST
/
v1
/
subscriptions
Criar assinatura
curl --request POST \
  --url https://hml.4seletpay.com.br/api/v1/subscriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'account: <account>' \
  --data '
{
  "international": false,
  "client": {
    "client_ip": "192.168.1.100",
    "name": "Carlos Ferreira",
    "email": "carlos@exemplo.com.br",
    "gender": "Male",
    "birthdate": "1985-06-20",
    "phone": {
      "ddi": 55,
      "ddd": 11,
      "number": "977776666"
    },
    "document": {
      "type": "CPF",
      "number": "111.222.333-44"
    },
    "address": {
      "zipcode": "04538-132",
      "street": "Rua Fidêncio Ramos",
      "number": 302,
      "neighborhood": "Vila Olímpia",
      "complement": "Torre B",
      "city": "São Paulo",
      "state": "SP",
      "country": "Brasil"
    }
  },
  "subscription": {
    "interval": 30,
    "code": "plano_mensal_001",
    "description": "Plano Mensal Premium",
    "installments": 1,
    "max_invoices": 12,
    "minimum_price": 9990,
    "billing_type": "prepaid",
    "discounts": {
      "cycles": 1,
      "value": 10,
      "type": "percentage"
    },
    "metadata": {
      "origem": "site"
    }
  },
  "payment": {
    "type": "CreditCard",
    "card": {
      "number": "4111111111111111",
      "name": "CARLOS FERREIRA",
      "month": "08",
      "year": "28",
      "security_code": "456"
    }
  },
  "items": [
    {
      "id": "plano_premium",
      "description": "Acesso Premium Mensal",
      "amount": 99.9,
      "quantity": 1
    }
  ]
}
'
{
  "success": true,
  "message": "Assinatura criada com sucesso",
  "data": {
    "subscription_code": "sub_abc123",
    "status": "Active",
    "interval": 30,
    "payment_method": "CreditCard",
    "next_billing_date": "2026-04-11",
    "created_at": "2026-03-11T10:00:00.000000Z"
  }
}
Requer o header account. Passa por validações de fraude e bloqueio de clientes.

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

Lista de itens da assinatura (obrigatório)

international
boolean | null

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

Example:

false

Response

Assinatura criada com sucesso

success
boolean
Example:

true

message
string
Example:

"Assinatura criada com sucesso"

data
object