Solicitar Permissões de Acesso ao Usuário

Página de solicitação de acessoPágina de solicitação de acesso

Página de solicitação de acesso

Para solicitar as permissões você deverá montar a URL com os parâmetros descritos abaixo e redirecionar o usuário para esta URL.

Após o usuário conceder a permissão, você receberá um novo code para utilizar em uma nova requisição server-side para de fato receber o access token que lhe dará os acessos concedidos.

❗️

ATENÇÃO

O redirect_uri deve ser exatamente o mesmo que foi cadastrado na criação do APP.

Scopes Disponíveis

Nome

RECEIVE_FUNDS

Permissão para criação e consulta de PEDIDOS, PAGAMENTOS, MULTIPEDIDOS, MULTIPAGAMENTOS, CLIENTES e consulta de LANÇAMENTOS. Permissão para obtenção do arquivo de Conciliação de Vendas.

REFUND

Permissão para criação e consultas de reembolsos de PEDIDOS, PAGAMENTOS.

MANAGE_ACCOUNT_INFO

Permissão para consulta de informações cadastrais de ACCOUNTS.

RETRIEVE_FINANCIAL_INFO

Permissão para consulta de saldo de através do endpoint BALANCES e obtenção do arquivo de Conciliação Financeira.

TRANSFER_FUNDS

Permissão para transferências bancárias ou para contas Moip através do endpoint TRANSFERS.

DEFINE_PREFERENCES

Permissão para criação, alteração e exclusão de preferências de notificação através do endpoint PREFERENCES.

📘

EXEMPLO

Para que você possa pedir permissão aos sellers você deve montar uma URL com dados como APP id e scopes. Veja abaixo um exemplo de URL com as permissões que se quer obter dos vendedores de seu marketplace/plataforma:

https://connect-sandbox.moip.com.br/oauth/authorize?response_type=code&client_id=APP-QQ1NUNIKRQ9B&redirect_uri=https://moip.com.br/&scope=RECEIVE_FUNDS,TRANSFER_FUNDS

Você deve redirecionar seu seller para esta URL, pois é nela que o usuário concederá (ou não) permissão de acesso às informações.

🚧

IMPORTANTE

Você pode enviar parâmetros adicionais para identificação do seu usuário usando
query-params, porém é necessário que você faça o encode da URL para que os parâmetros enviados não entrem em conflito com os parâmetros obrigatórios.

EXEMPLO

https://connect-sandbox.moip.com.br/oauth/authorize?response_type=code&client_id=APP-QQ1NUNIKRQ9B&redirect_uri=https://moip.com.br/?my_seller_id_123&scope=RECEIVE_FUNDS,TRANSFER_FUNDS

Como funciona a permissão?

1. O cliente é redirecionado à página de solicitação de permissão;
2. nesse momento o Moip checará se o cliente está logado. Se estiver, serão exibidas as opções de aceitar ou recusar o vínculo com seu app;
3. caso a permissão seja concedida, o usuário será redirecionado para a sua URL de redirecionamento (redirect_uri) com o code referente à confirmação do usuário.

EXEMPLO

http://meusite.com.br/?code=ohgrvfk2kdq92w27w66mlntasfh24je

Language
Authentication
Basic
base64
: