Skip to main content
POST
/
v1
/
payment-links
curl --request POST \
  --url https://sandbox.4seletpay.com.br/api/v1/payment-links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'account: <account>' \
  --data '
{
  "client": {
    "name": "Hugo Belo",
    "email": "hugo@exemplo.com.br",
    "phone": {
      "ddi": "55",
      "ddd": "62",
      "number": "984063942"
    },
    "document": {
      "type": "CPF",
      "number": "71854312120"
    }
  },
  "items": [
    {
      "id": "plano-premium",
      "description": "Plano Mensal Premium",
      "amount": 97.99,
      "quantity": 1
    }
  ],
  "config": {
    "payment_types": [
      "CreditCard",
      "PIX"
    ],
    "expires_at": "2026-12-31 23:59:59",
    "max_uses": 100,
    "pix_discount_value": 10,
    "pix_discount_type": "percentage",
    "redirect_url": "https://meusite.com.br/obrigado"
  }
}
'
{
  "mensagem": "Link de pagamento criado com sucesso",
  "erro": false,
  "mensagenserro": [],
  "codigoretorno": 201,
  "id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "code": "lnk_abc123xyz",
    "order_code": "ord_abc123xyz",
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "url": "https://checkout.4seletpay.com.br/lnk_abc123xyz?token=a1b2c3d4e5f6...",
    "status": "InProgress",
    "payment_types": [
      "CreditCard",
      "PIX"
    ],
    "installments": [
      {
        "count": 1,
        "interest_rate": 1
      },
      {
        "count": 2,
        "interest_rate": 1
      }
    ],
    "obfuscate_client": false,
    "obfuscate_items": false,
    "expires_at": "2026-12-31T23:59:59.000000Z",
    "max_uses": 100,
    "uses_count": 0,
    "split": [],
    "value": 97.99,
    "created_at": "2026-05-27T10:00:00.000000Z"
  }
}
Requer o header account com o código da conta. O link gerado é imediatamente ativo e pode ser compartilhado com clientes.
Para definir uma imagem no checkout, envie config.image com uma URL pública ou uma string base64. O servidor processa e armazena automaticamente. Se o processamento falhar, o link é criado normalmente e a resposta incluirá o campo image_warning.

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

Produtos ou serviços incluídos no link. Total mínimo (itens + frete) = R$ 5,00.

Minimum array length: 1
​
config
object

Configurações opcionais do link

Response

Link de pagamento criado com sucesso

​
mensagem
string
Example:

"Link de pagamento criado com sucesso"

​
erro
boolean
Example:

false

​
mensagenserro
string[]
Example:
[]
​
codigoretorno
integer
Example:

201

​
id
string
Example:

"00000000-0000-0000-0000-000000000000"

​
data
object