Implementing Partner Split

Things to do to successfully integrate your Partner Split solution with Liberis

Required Steps

Payment Processors using Partner Split must integrate as follows:

When

Payment Processor

Liberis

An ActionRequired Webhook is received by the Payment Processor

Call the GetAccountById endpoint to determine what action is required.

Process the action according to its type. See the Actions section for more details.

N/A

An Action has been processed by the Payment Processor

Call the Record Action endpoint to record the result of the action.

Updates the status of the Payment Account.

If another action is required, a new webhook will be sent.

(At least) once per day

Call the GetAllAccounts endpoint to retrieve all associated Payment Accounts.

This is a useful way to ensure that there are no actions that haven't been completed.

If so, follow the previous steps as if a webhook has been received.

N/A

When settling revenue for a merchant with an active split

Call the Balance endpoint to retrieve the amount due to Liberis.

Calculate how much to pay to Liberis and then pay the remainder to the merchant.

Notify Liberis of the payment by calling the Settlement Api.

Records the payment amount against the balance of the Payment Account.

An active split has been turned off by the Payment Processor for any reason

Send a successful FINISH action to the Record Action endpoint.

Record that the split has been turned off for this merchant.