A PayVip permite que você desenvolva de forma rápida, simples e com poucas linhas de código as melhores soluções em automação financeira e divisão inteligente de pagamentos (split).
\nNossa tecnologia e infraestrutura financeira possibilita criar soluções de pagamentos, contas digitais e conciliação automática sem burocracia.
\nA infraestrutura segue o mais alto padrão de segurança, garantindo a proteção total dos dados de cartões e transações.
\nToda a tecnologia é 100% aderente às regulações do Banco Central e ao sistema de pagamentos brasileiro (SPB).
\nCom o Split PayVip, sua empresa pode oferecer:
\nAceitação de pagamentos online e presencial
Receba via cartão, Pix ou boleto com divisão automática entre participantes.
Gestão de contas digitais
Crie e gerencie contas de clientes, parceiros e fornecedores dentro da sua plataforma.
Controle inteligente de recebíveis
Antecipe, divida e acompanhe repasses em tempo real.
Com o Split PayVip, você reduz drasticamente seu time-to-market e entra no mercado financeiro sem precisar lidar com regulamentações complexas ou infraestrutura bancária.
\nFoque no seu produto — nós cuidamos do split, dos repasses, da segurança e da conformidade.
\n\nOs requisitos vem com o propósito de melhorar a segurança com acesso à plataforma PayVip, visando mitigar os riscos de ataques cibernéticos, exigindo a implementação de controles mínimos de segurança independente da tecnologia utilizada pelo parceiro (Web, Mobile ou Application), tendo o cliente como responsável a implementação dos seguintes requisitos mínimos em sua plataforma:
\nTransporte
\nTodas as comunicações entre o cliente o a plataforma devem ocorrer por HTTPS usando a versão a partir do TLS 1.2.
\nTodas as interfaces acessíveis ao público na internet, devem usar um Certificado Digital que tenha sido assinado por uma autoridade de certificação aprovada e legítima.
\nSempre que possível crie uma lista de permissões de IP’s (WhiteList) para limitar e controlar o acesso apenas de recursos autorizados.
\nSempre que possível, utilize soluções para controlar o acesso da rede como Firewall e WAF (Web Application Firewall).
\n⚠️ Importante:
\nAs chaves de API fornecidas pela PayVip devem ser utilizadas apenas com TLS habilitado. Nunca inclua essas chaves na URL ou em strings de consulta, pois podem ser armazenadas de forma não segura por navegadores ou servidores, expondo suas credenciais. Sempre envie as chaves no cabeçalho HTTP.
\nAlém disso, evite o uso de URLs curinga (por exemplo, Access-Control-Allow-Origin:\\*) nos cabeçalhos de resposta, exceto em casos onde o recurso REST seja público e não exija autenticação.
A API PayVip 360 foi desenvolvida seguindo os princípios RESTful, com recursos orientados por URLs e uso de códigos HTTP para indicar o status das operações. Os verbos HTTP utilizados são:
\nPOST – criação de recursos
PUT – atualização de recursos
GET – leitura de dados
DELETE – remoção de recursos
Todas as respostas da API são retornadas em formato JSON, incluindo mensagens de erro.
\nA API suporta CORS (Cross-Origin Resource Sharing), permitindo chamadas seguras a partir de aplicações web hospedadas em domínios diferentes. Isso facilita a integração com sistemas externos e aplicações frontend.
\nOs seguintes números de cartão de crédito podem ser usados para simular transações em ambiente de teste (sandbox), para pagamentos bem-sucedidos:
\nAlém disso, esses são os números \"mágicos\" de cartões que gerarão respostas específicas, úteis para testar diferentes cenários:
\nEm poucas palavras, existem apenas 3 resultados na interação entre seu aplicativo e nossa API:
\nTudo funcionou
\nO aplicativo fez algo errado
\nA API fez algo errado
\nA API PayVip 360 tenta retornar códigos de status de resposta HTTP apropriados para cada solicitação.
\nEm geral, os códigos no intervalo 2xx indicam sucesso, os códigos no intervalo 4xx indicam um erro resultante das informações fornecidas (por exemplo, um parâmetro necessário faltou, uma transação falhou, etc.) e os códigos no intervalo 5xx indicam um erro com os servidores da PayVip.
\nA tabela a seguir contém os valores mais comuns para os códigos de status HTTP retornados pela API:
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"✅Introdução","slug":"introducao"},{"content":"🔐 Requisitos de Segurança","slug":"requisitos-de-seguranca"},{"content":"🌐 Design da API","slug":"design-da-api"},{"content":"🌍 CORS e Integração Web","slug":"cors-e-integracao-web"},{"content":"💳Bandeiras Aceitas","slug":"bandeiras-aceitas"},{"content":"❌Códigos de erro","slug":"codigos-de-erro"}],"owner":"3966623","collectionId":"be9c248c-918b-43a7-9591-ff1de5558107","publishedId":"2sB3WjyiR3","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-10-24T13:57:20.000Z"},"item":[{"name":"Autenticação na API 360 PayVip","item":[{"name":"Login API 360","id":"77237a87-2196-45e7-9b1d-2e09044974b2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"user\": \"{{user}}\",\r\n \"passwd\": \"{{password}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api360.payvip-api.io/login","description":"Esta rota autentica o usuário na plataforma 360 PayVip e retorna um token JWT para uso nas demais requisições da API.
\nidToken: Token JWT para autenticação nas próximas requisições.
\nexpiresIn: Tempo de expiração do token (em segundos).
\nlocalId: Identificador único do usuário.
\nemail: E-mail do usuário autenticado.
\nPara autenticação na API 360 PayVip é necessário os seguintes passos:
\nMétodo: POST
Função:
\nValida as credenciais do usuário e retorna um JWT (idToken) para autenticação nas requisições subsequentes.
\nChaves de API: Fornecidas previamente para integração.
\nseller_id e people_id: Necessários para consultas aos endpoints. Estes identificadores podem ser obtidos através do nosso canal de suporte.
\nE-mail: suporte@payvip.com.br
\nWhatsApp: +55 11 4003-5397
\nImportante:
\nInclua o token JWT no header das requisições protegidas:
\nAuthorization: Bearer {idToken}\n\nA Conta Digital PayVip é um conjunto de APIs que permite gerenciar transações financeiras de forma segura e integrada. O serviço disponibiliza extratos detalhados de todos os lançamentos realizados na plataforma, além de possibilitar transferências para contas bancárias de mesma titularidade, garantindo a liquidação dos valores de recebíveis.
\nCom a Conta Digital PayVip, você pode:
\nCriar um novo vendedor (seller/parceiro): Ao informar dados básicos como CPF/CNPJ e nome, uma conta digital PayVip é criada automaticamente.
\nConsultar extratos via API: Visualize todos os lançamentos de crédito e débito associados à conta digital, com saldo atualizado.
\nDisponibilizar saldo para saque: Permita que o cliente (seller) realize transferências para sua conta bancária, criando ordens de pagamento com base no saldo disponível.
\nExtrato detalhado: Registro completo de lançamentos de crédito, débito e saldo atualizado.
\nTransferências (payout): Suporte para realizar transferências para contas bancárias, seguindo regras de cobrança pré-definidas, como taxas aplicadas por operação.
\nIntegração segura: APIs robustas para garantir confiabilidade e conformidade com padrões financeiros.
\nEssa rota permite consultar os dados cadastrais básicos de uma pessoa (vendedor) a partir de seu identificador único (people_id).
O campo id retornado na resposta corresponde ao seller_id na PayVip, que é o identificador interno do vendedor na plataforma.