Primeiros Passos
Configure sua integração com a API Versell Pix em poucos passos
1Obtenha suas credenciais
Entre em contato com a equipe Versell para receber seu client_id, client_secret e o certificado mTLS. Essas credenciais são necessárias para autenticar todas as requisições à API.
2Configure o certificado mTLS
Todas as requisições à API Versell exigem autenticação mútua TLS (mTLS). Você receberá um certificado (.pem) e uma chave privada (.key) que devem ser enviados em cada requisição.
curl -X POST https://api.pix.basspago.com.br/oauth/token \
--cert ./client.crt \
--key ./client.key \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials"3Obtenha o Access Token
Use o fluxo OAuth2 client_credentials para obter um token de acesso. O token é necessário no header Authorization de todas as requisições subsequentes.
curl -X POST https://api.pix.basspago.com.br/oauth/token \
--cert ./client.crt \
--key ./client.key \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials"4Faça sua primeira requisição
Com o token em mãos, crie sua primeira cobrança Pix (QR Code dinâmico):
curl -X PUT https://api.pix.basspago.com.br/v2/cob/{txid} \
--cert ./client.crt \
--key ./client.key \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"calendario": {
"expiracao": 3600
},
"valor": {
"original": "10.00"
},
"chave": "YOUR_PIX_KEY",
"solicitacaoPagador": "Payment for Order #123"
}'5Configure Webhooks
Configure webhooks para receber notificações em tempo real quando um pagamento for recebido ou quando uma transferência for concluída. Você pode configurar via API ou diretamente pelo painel do Finance. O Finance também permite acompanhar todas as transações e dados de pagamentos.
6Vá para produção
Teste sua integração no ambiente sandbox, valide todos os fluxos (cobrança, recebimento, webhook, reembolso) e então migre para o ambiente de produção com as credenciais definitivas.