Skip to main content

Onboarding

The onboarding process takes place mainly on Verestro side. In order to perform onboarding, the Customer has to provide some information needed to correctly configure him an account in Donate Widget Server. Configuration includes following information:

  • Customer name – Basically, it's the name of the Customer's company. The following parameter will be displayed to the user in pay donation form – example appearance can be found here.

  • Description – Information about the purpose of the donation. The following parameter will be displayed to the user in pay donation form – example appearance can be found here.

  • Redirect URL’s - Those are the addresses to which user will be redirected after a successful or unsuccessful transaction. These parameters will be added to the Customers's account configuration.

  • Postback URL - This is the address to which information about the donation will be send to the Customer. This parameter is not required if the Customer does not want to receive notifications regarding the donation - more detailed information about the postbacks can be found here.

  • Notification to the User - It is a flag that defines whether e-mail notifications will be sent to the User. Such e-mail contains the donation status, donation identifier, date and amount.

  • Term of use and privacy notes URL – addresses where the Customer stores above-mentioned documents.

  • Customer's pictures – These are images that could be, for example, the Customer's logo. They will be posted as requested by Customer in the pay donation form and in the e-mail notification. This point is optional. If the Customer does not provide such pictures, the pay donation form will be shown with it's default appearance – example appearance can be found here.

After creating an account for the Customer, Verestro provides all necessary data for Customer which allow to use the solution. Such data includes:

  • api key – value that defines a Customer in the context of donation process offered by Verestro. The value api-key should be send by the Customer in every request - Verestro system maps the request with the proper Customer's account. Technical information about the api-key can be found here.

  • basic authorization - it is the login and password of the Customer account in the Verestro system. Basic authorization is needed if the Customer wants to download transaction data via the "get transaction details" method.

The Customer must also have to create an account in the Acquirer's system which settles transactions. Such an account is defined by the MID parameter (to find out what MID is, see the "Terminology" chapter). This is a very important parameter as it is required for payment processing. This parameter, together with it's authorization data, can be provided to Verestro by the Customer. Verestro offers support in creating such an account if it has integration with a given Acquirer. If the client requires transactions to be processed with the participation of a new Acquirer, then Verestro must perform a new integration. The client is then responsible for providing the documentation that Verestro will use during the integration.

The solution allows to assign one terminal to Customer account. If the Customer wants to operate several terminals, it requires the creation of additional Customer accounts (account per terminal) or development on the Verestro side that will handle such a requirement.

Back to top