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"
}
}{
"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": []
}Links de Pagamento
Criar Link de Pagamento
Cria um novo link de pagamento com checkout pré-configurado e URL única com token de segurança. Suporta CreditCard, PIX e Boleto. Compartilhe o campo url da resposta diretamente com o cliente.
O campo config.image aceita URL pública HTTPS ou string base64 — processado e armazenado automaticamente (fail-soft: se falhar, o link é criado normalmente sem imagem e a resposta incluirá image_warning).
Requer o header account com o código da conta.
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"
}
}{
"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. 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
Token JWT obtido via POST /v1/login. Envie no header Authorization: Bearer <token>.
Headers
Código da conta à qual a operação se aplica
Example:
"acc_abc123xyz"
Body
application/json
O objeto client é opcional. Se omitido, os dados do pagador serão coletados no checkout. Se qualquer campo de client for enviado, os campos name, email, phone e document tornam-se obrigatórios.