O Gateway Pay7 é uma API REST na qual nossos usuários podem gerar transações PIX com facilidade.

<aside> 🛠 Todas as requisições devem ser feitas para https://api.pay7seven.com/v0_1/

</aside>

Criando uma Empresa

A sua empresa será criada internamente pela nossa equipe. Após isso você receberá um client_id e um client_secret que deverá ser usado para gerar um token de acesso aos nossos serviços.

<aside> ⚠️ O client_secret é uma informação sensível que não deverá ser passada para terceiros. Ela fornece controle a sua carteira Pay7. Se por qualquer motivo você precisar invalidar o client_secret da sua empresa, nos contate imediatamente para que possamos gerar um novo.

</aside>

Autenticando pela API

Toda requisição em nossa API é autenticada pelo campo token no header do request.

Esse token de autenticação pode ser adquirido através do endpoint /auth.

Aqui um exemplo de como adquirir um token:

1. Realize uma requisição POST para a URL:

<https://api.pay7seven.com/v0_1/auth?cnpj=><cnpj-da-sua-empresa>

1. Inclua como header da requisição seu client_id e client_secret:

"client_id": "<seu-client-id>",
"client_secret": "<seu-client-secret>"

1. O endpoint irá te retornar o token de acesso, bem como o horário de expiração do mesmo

{
    "access_token": "9e25612efb5d6f44c18cd19895e274eb",
    "expiration_date": "2024-04-15T19:15:23.952255"
}

<aside> ⚠️ Os tokens de acesso são válidos por 60 minutos, depois desse tempo você precisará gerar outro token.

</aside>

<aside> ⚠️ Você deve incluir seu novo access_token no Header de toda requisição que fizer para nosso serviço.

</aside>

Gerenciando transações