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_urideve ser exatamente o mesmo que foi cadastrado na criação do APP.
Scopes Disponíveis
Nome |
|---|
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. |
Permissão para criação e consultas de reembolsos de PEDIDOS, PAGAMENTOS. |
Permissão para consulta de informações cadastrais de ACCOUNTS. |
Permissão para consulta de saldo de através do endpoint BALANCES e obtenção do arquivo de Conciliação Financeira. |
Permissão para transferências bancárias ou para contas Moip através do endpoint TRANSFERS. |
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:
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
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