Boarding process

The section below gives an example of a successful merchant boarding process.

  1. Submitting a boarding request
  2. The Boarding Platform sends a notification
  3. The Boarding Platform performs compliance checks
  4. Amending the merchant data
  5. Adding other payment methods to a boarding request
  6. Promoting the merchant to a platform merchant

Submitting a boarding request

You can submit a boarding request by sending the required data in the specified (base64 encoded) XML format to the Boarding Platform via an HTTPS POST call using the submit method. The PPRO Boarding Platform's system performs basic validation on the boarding request. If the request is valid, a merchant is created in the Boarding Platform that has the initial statuses PENDING and UNKNOWN. The Boarding Platform synchronously sends a response with a request status back to you.

StatusDescription
SUCCEEDEDThe boarding request is valid and has been successfully submitted. The merchant has been created. The Boarding Platform proceeds with screening the merchant and will notify you of the result. Wait for a notification regarding the boarding request.
FAILEDThe boarding request failed. No further actions are taken by the Boarding Platform. The response contains the reason details about the rejection. The boarding request may be resubmitted after adjustments.

The Boarding Platform sends a notification

The Boarding Platform notifies you whenever there is a change in the operational, compliance, or payment method provisioning statuses. To retrieve the status, use the getstatus method to retrieve the status.

The common notifications in a normal, successful boarding process are:

  1. Upon merchant activation, when a merchant is flagged compliant and the merchant account provisioning is complete. In case of a failure due to compliance, the Boarding Platform sends this notification too.
  2. Upon successful technical provisioning of each requested payment method. If failed, the Boarding Platform sends a notification as well.

The Boarding Platform performs compliance checks

The Boarding Platform performs several compliance checks on a merchant that impacts their compliance status. Compliance checks are part of the boarding process. Girolink also performs recurring standalone processes.

Initial obligatory checks

After creating a merchant as part of the boarding process, we run all the obligatory compliance checks. These checks set the merchant to either a Compliant or NonCompliant status.

Recurring and extensive checks

Once a merchant is Active, we perform periodic process checks for the further compliance of the merchant. The checks performed in this process are more in-depth and can render a merchant NonCompliant.

Actions taken by PPRO

There are several actions that PPRO performs in the context of the compliance processes:

  • If the merchant is set NonCompliant before activation, the merchant is Suspended and the issue has to be resolved by the partner.
  • If the merchant is set from NonCompliant after activation, the partner has a fixed period of time to resolve the issue before the merchant is Suspended.
  • If a merchant is set NonCompliant and it is a major violation, PPRO may cancel the merchant account. Thus, the merchant is set to Canceled.
  • If a NonCompliant merchant resolves the compliance violation, PPRO will flag the merchant Compliant. If Suspended, the merchant account is (re)activated, thus set to Active.

Amending the merchant data

After successfully submitting a boarding request, you can amend the merchant data by using the amend call to the PPRO Boarding Platform.

🚧

Warning

Amendments can trigger compliance checks and cause a change of the compliance status, and ultimately, a change of the operational status.

Use the amend call to update merchant data whenever there is a change. It can also serve as a tool when resolving compliance issues cause by incorrect merchant data.

❗️

Important

The amend call cannot request payment methods to be added to the merchant.

Adding another payment method to a boarding request

After successfully submitting a boarding request, you can add an additional payment method to it using the addpaymentmethod call. The provisioning process of the payment method for the merchant is initiated upon a successful request.

Promoting a merchant to platform merchant

After submitting a successful boarding request, you can promote the boarded merchant to a platform merchant using the promotetoplatform call, as long as the merchant does not belong to a platform itself. After promotion, The Boarding Platform performs compliance checks as if the merchant was boarded as a platform merchant.