Skip to main content

​
🚀 Comece em 3 passos

Configure sua integração com a UPay Gateway API e comece a processar pagamentos rapidamente.

​
Passo 1: Obtenha suas credenciais

Para começar, você precisa de uma conta UPay e suas credenciais de API.
  1. Acesse o Dashboard UPay
  2. Faça login ou crie uma conta
  3. Complete o processo de KYC (Know Your Customer)
  4. Navegue até Configurações → API Keys
  5. Gere uma nova API Key
  6. Importante: Guarde sua API Key em local seguro, ela não será exibida novamente
Nunca compartilhe sua API Key publicamente. Mantenha-a segura e use variáveis de ambiente.
A URL base da API UPay é:
https://https://upay-sistema-api.onrender.com/
Todas as requisições devem ser feitas para este endpoint, com exceção dos endpoints públicos de checkout.

​
Passo 2: Faça sua primeira requisição

Teste sua API Key fazendo uma requisição para listar seus links de pagamento:
curl -X GET "https://https://upay-sistema-api.onrender.com//api/v1/payment-links" \
  -H "Authorization: Bearer SUA_API_KEY_AQUI" \
  -H "Content-Type: application/json"
Substitua SUA_API_KEY_AQUI pela sua API Key real.
Exemplo usando fetch em JavaScript:
const apiKey = 'SUA_API_KEY_AQUI';
const response = await fetch('https://https://upay-sistema-api.onrender.com//api/v1/payment-links', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);
Exemplo usando requests em Python:
import requests

api_key = 'SUA_API_KEY_AQUI'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://https://upay-sistema-api.onrender.com//api/v1/payment-links',
    headers=headers
)

data = response.json()
print(data)
Se você tiver cupons configurados, pode validá-los no checkout:
curl -X POST "https://https://upay-sistema-api.onrender.com//api/v1/coupons/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "DESCONTO10",
    "amount": 100.00
  }'
Este endpoint é público e não requer autenticação.

​
📚 Próximos passos

Agora que você fez sua primeira requisição, explore estas funcionalidades:

Autenticação

Aprenda sobre autenticação e segurança da API.

Links de Pagamento

Crie e gerencie links de pagamento personalizados.

Produtos

Gerencie seu catálogo de produtos.

Webhooks

Configure webhooks para receber notificações em tempo real.

​
🆘 Precisa de ajuda?

Dúvidas? Entre em contato com nosso suporte em [email protected] ou consulte a documentação completa da API.