Request User Access Permissions

Access request page.Access request page.

Access request page.

To request permissions, you must set up the URL with the parameters described below and redirect the user to this URL .

After the user grants the permission, you will receive a code to use in a new server-side request to actually receive the access token that will give you the granted access.

❗️

ATTENTION

The redirect_uri must be exactly the same as what was registered when APP was created.

Available Scopes

Name

Description

RECEIVE_FUNDS

Permission to create and consult ORDERS , PAYMENTS , MULTIORDERS , MULTIPAYMENTS , CLIENTS and consultation of ENTRIES . Permission to obtain the sales reconciliation file.

REFUND

Permission to create and consult refunds for ORDERS , PAYMENTS .

MANAGE_ACCOUNT_INFO

Permission to consult the information about ACCOUNTS.

RETRIEVE_FINANCIAL_INFO

Permission to check balance via endpoint ACCOUNTS and obtain the financial conciliation file.

TRANSFER_FUNDS

Permission for bank transfers or Wirecard accounts via endpoint TRANSFERS .

DEFINE_PREFERENCES

Permission to create, change and delete notification preferences via endpoint PREFERENCES .

📘

EXAMPLE

In order for you to ask permission from sellers you must set up a URL with data such as App id and scopes. Below is an example of a URL with the permissions you want to obtain from your marketplace/platform vendors:

https://connect-sandbox.wirecard.com.br/oauth/authorize?response_type=code&client_id=APP-DVLJHW59IKOS&redirect_uri=https://myecommerce.com/callback.php&scope=RECEIVE_FUNDS,REFUND,MANAGE_ACCOUNT_INFO,TRANSFER_FUNDS

You must redirect your seller to this URL, as this is where the user will grant (or not) permission to access his information.

🚧

IMPORTANT

You can send additional parameters to make the user identification using
query-params, but it is necessary that you encode the URL so that the parameters sent do not conflict with the mandatory parameters.

EXAMPLE

https://connect-sandbox.wirecard.com.br/oauth/authorize?response_type=code&client_id=APP-M11STAPPOAUt&redirect_uri=https%3A%2F%2Flabs.moip.com.br%3F**my_seller_id%sell321**&scope=RECEIVE_FUNDS

How does permission work?

1. The seller is redirected to the permission request page;
2. at that time Wirecard will check if the customer is logged in. If so, the options to accept or decline the link to your app will be displayed;
3. if permission is granted, the user will be redirected to their redirect URL (redirect_uri) with thecode referring to the user's confirmation.

EXAMPLE

http://yourecommerce.com/?code=ohgrvfk2kdq92w27w66mlntasfh24je

Language
Authentication
Basic
base64
: