Documentação
Integre a VertPay ao seu sistema
Use a API da VertPay para gerar cobranças PIX, consultar saldos e verificar pagamentos diretamente no seu projeto, loja ou script.
🌐 Base URL: https://vertpay.site/api/
Como começar
1
Crie sua conta
Cadastre-se em vertpay.site/register.php e aguarde a aprovação.
Cadastre-se em vertpay.site/register.php e aguarde a aprovação.
2
Configure seu gateway
Acesse vertpay.site/meu_gateway.php e cadastre sua chave PIX.
Acesse vertpay.site/meu_gateway.php e cadastre sua chave PIX.
3
Copie seu token
Após salvar, você recebe um token único. Use-o em todas as requisições.
Após salvar, você recebe um token único. Use-o em todas as requisições.
4
Faça sua primeira chamada
Use o token no header
Use o token no header
Authorization: Bearer SEU_TOKEN.
🔑
Autenticação: todas as requisições precisam do header
Authorization: Bearer SEU_TOKEN. Seu token está disponível em Meu Gateway.Endpoints
POST
▼
/api/pagar.php
Gerar cobrança PIX
💡
Gera um QR Code PIX para seu cliente pagar. Após o pagamento, o valor (menos a taxa) é creditado no seu saldo VertPay automaticamente.
Parâmetros do body (JSON)
| Campo | Tipo | Obrig. | Descrição |
|---|---|---|---|
| amount | number | Sim | Valor em reais (ex: 49.90) |
| payer_name | string | Não | Nome do pagador (opcional) |
| payer_cpf | string | Não | CPF do pagador (opcional) |
Exemplo de requisição
// PHP
$ch = curl_init('https://vertpay.site/api/pagar.php');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer SEU_TOKEN',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'amount' => 49.90,
'payer_name' => 'João Silva',
'payer_cpf' => '12345678900',
]),
]);
$response = json_decode(curl_exec($ch), true);
Exemplo de resposta (sucesso)
{
"success": true,
"txid": "abc123...",
"external_id": "api_1234567890_2",
"qrcode": "00020126...",
"qrcode_image": "https://api.qrserver.com/...",
"amount": 49.90,
"taxa": 4.50,
"valor_liquido": 45.40,
"expires_in": 600,
"status": "aguardando_pagamento"
}
💰
Taxa: 5% do valor + R$2,00 fixo. Exemplo: pagamento de R$49,90 → taxa R$4,50 → você recebe R$45,40.
GET
▼
/api/status.php?txid=TXID
Verificar status de pagamento
💡
Consulte se um PIX foi pago usando o
txid retornado ao gerar a cobrança. Use em polling a cada 3-5 segundos.Exemplo de requisição
// PHP
$ch = curl_init('https://vertpay.site/api/status.php?txid=abc123');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer SEU_TOKEN'],
]);
$response = json_decode(curl_exec($ch), true);
Resposta — aguardando
{
"txid": "abc123",
"status": "pendente",
"paid": false
}
Resposta — pago
{
"txid": "abc123",
"status": "pago",
"paid": true,
"valor_bruto": 49.90,
"valor_liquido": 45.40,
"pago_em": "2026-05-03 21:37:43"
}
GET
▼
/api/saldo.php
Consultar saldo e histórico
Exemplo de requisição
// PHP
$ch = curl_init('https://vertpay.site/api/saldo.php');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer SEU_TOKEN'],
]);
$response = json_decode(curl_exec($ch), true);
Exemplo de resposta
{
"success": true,
"saldo": 245.80,
"moeda": "BRL",
"pagamentos": [
{
"txid": "abc123",
"valor_bruto": 49.90,
"valor_liquido": 45.40,
"criado_em": "2026-05-03 21:37:43"
}
]
}
Exemplo completo — PHP
// 1. Gerar PIX
$ch = curl_init('https://vertpay.site/api/pagar.php');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer SEU_TOKEN',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'amount' => 50.00,
'payer_name' => 'Cliente Teste',
'payer_cpf' => '12345678900',
]),
]);
$pix = json_decode(curl_exec($ch), true);
// 2. Mostrar QR Code para o cliente
echo '<img src="' . $pix['qrcode_image'] . '">';
echo $pix['qrcode']; // código copia e cola
// 3. Verificar pagamento (polling)
$txid = $pix['txid'];
while(true) {
$ch = curl_init("https://vertpay.site/api/status.php?txid=$txid");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer SEU_TOKEN'],
]);
$status = json_decode(curl_exec($ch), true);
if($status['paid']) {
echo 'Pagamento confirmado! Valor: R$' . $status['valor_liquido'];
break;
}
sleep(4);
}
Códigos de erro
📱
Suporte: dúvidas ou problemas na integração? Entre em contato pelo WhatsApp +55 11 91066-3490