Split Transfer Integration

Introduction

The Split Payments service is offered as an ideal model for the distribution of balances from a previous payment operation. This service is available in REST and XML integration, therefore any call to the split_transfer or split_transfer_reversal service must originate with a previous execute_purchase, execute_purchase_dcc or preauthorization_confirm operation.

This will generate a balance on the product from which the transaction originates. This balance will be the transaction total, minus the financial commission of the purchase. Once the purchase operation is finalised, as many split_transfer as desired may be sent to other destination accounts on PAYCOMET. This split_transfer operation can be executed provided that there is a balance in the account of the product that generated the operation and that no more than 90 days have passed since the initial purchase.

The only information necessary to generate a split_transfer to a destination account is the Split Id. parameter. This information may be taken from the PAYCOMET control panel on (Terminals -> Terminal name" -> Terminal details -> Integration credentials).

The Split Id. information must be sent securely to the transaction issuer so that they can deposit the proportional part of their services through the split_transfer after a purchase.

This service is widely used by Marketplaces to charge a single operation to the end client. In this way, the Marketplace receives the total amount of the operation and when the real supplier provides the service or merchandise, they are immediately paid a split_transfer of the total amount of the transaction, minus its commission. It is also very useful for charging commissions for advertising and services, etc., without the end client being affected by two charges. This service also allows the legal protection that European legislation requires with regard to receipt of the amounts by an authorised Payment Entity such as PAYCOMET by Banco de España.

Split Payment Transfer Process

1. Pay-In process (Pay-In)

Charging of the operation may be carried out by any of the processes of the product from PAYCOMET. These may be:

• execute_purchase
• execute_purchase_dcc
• preauthorization_confirm

2. Split Transfer process

The Split Transfer process may be automatic (the program defined by PAYCOMET and the client not changing anything in its integration) or on demand. In case of being on demand, the company must subsequently make a payment, a split_transfer operation to make a deposit in a destination account or a split_transfer_reversal if they wish to reverse a previously executed split_transfer. It is very important to know that these services may always be carried out provided that there is a sufficient balance to cover the amounts of the transfers.

The two services that can be called are:

• split_transfer here you can access the service: (by XML)
• split_transfer_reversal here you can access the service: (by XML)

3. Withdrawals(Pay-Out)

The business may withdraw funds from their financial account by the usual PAYCOMET process. This may be automatic or on demand from the PAYCOMET "Retirada de fondos" control panel.

API Programming

Since the entire payment process is performed in the background (server to server) the changes to be performed in the business are totally unrelated to the user experience.

The technology used for the operation with the PAYCOMET payment gateway is SOAP, based on HTTPS to prevent transportation problems through firewalls and other devices while ensuring the safety of operations. There is extensive support for carrying out SOAP requests for the major programming languages used in web environments.

The requests are made through the HTTPS transport protocol, so you must ensure that your system is capable of correctly performing requests and managing security certificates returned by the platform to ensure proper use.

There are several operations that can be launched from the same service. The available operations are described below.

Execution of split transfer

Function: split_transfer

This method allows you to run a split transfer based on a previous authorization

Select the type of integration:

Execution of split transfer reversal

Function: split_transfer_reversal

This method allows you to run a split transfer reversal based on a previous split transfer

Select the type of integration:

Execution of transfer

Function: transfer

This method allows you to run a transfer

Select the type of integration:

Execution of transfer reversal

Function: transfer_reversal

This method allows you to run a transfer reversal based on a previous transfer

Select the type of integration: