Información general

Split Payments o pagos divididos es la forma de poder gestionar pagos entre el comercio, proveedores y vendedores, esta herramienta solo está disponible para cuentas ePayco en el modelo agregador.

A continuación, podrá encontrar los pasos a seguir para integrar correctamente esta funcionalidad en su comercio.

1. Activación del servicio

La cuenta principal (Comercio o Marketplace) debe tener Split Payment Activo, esta activación se debe solicitar vía ticket de soporte al área de servicio al cliente.

2. Matrícula de Comercios y Receptores

Una vez se encuentre activo el servicio. Es necesario registrar los comercios y receptores a los cuales se les va a dividir los pagos, desde el panel de clientes de ePayco en:  Pagos Divididos ingresando el email con el cual el usuario se encuentra registrado en la plataforma.

1. Click en Admin>Split payment>Receptores>Nuevos Usuarios

2. Completar el formulario

3. Tipos de integración

a. Pagos divididos Checkout

Con esta integración se podrá desplegar el checkout con las opciones de pagos divididos por medio de la siguiente configuración en javascript.

Agrega el script en su web.

<script type="text/javascript" src="https://checkout.epayco.co/checkout.js">   </script>
   

Configuración inicial

key: llave secreta del comercio.

test: true (prueba), false (producción).

  var handler = ePayco.checkout.configure({
                key: '45b960805ced5c27ce34b1600b4b9f54',
                test: true
            })
 

Configuración de variables

Iniciar un objeto con los  parámetros de la compra (Requerido),  Atributos cliente (Opcional) y  Ocultar métodos de pago.

     <script
            var handler = ePayco.checkout.configure({
            key: 'public_key comercio principal',
            test: false
        })
        var date = new Date().getTime();
        var data = {
            name: "Vestido Mujer Primavera",
            description: "Vestidó Mujer Prímaverá",
            invoice: date + 126351321,
            currency: "cop",
            amount: "10",
            tax_base: "0",
            tax: "0",
            country: "co",
            lang: "es",
            split_app_id: "30085",
            split_merchant_id: "30085",
            split_type: "01", 
            split_primary_receiver: "30085",
            split_primary_receiver_fee: "0", 
            splitpayment: "true",
            split_rule: "multiple",  
            split_receivers: [
                { "id": "19786", "total": "7", "iva": "", "base_iva": "", "fee": "3" },
                { "id": "93006", "total": "3", "iva": "", "base_iva": "", "fee": "1" }
            ],
            external: "false",
            //Los parámetros extras deben ser enviados como un string
            extra1: "extra1",
            extra2: "extra2",
            extra3: "extra3",
            extra9: "test| pipe|revisar|",
            confirmation: "http://secure2.payco.co/prueba_curl.php",
            response: "http://secure2.payco.co/prueba_curl.php",
            //Atributos cliente
            name_billing: "Andres Perez",
            address_billing: "Carrera 19 numero 14 91",
            type_doc_billing: "cc",
            mobilephone_billing: "3050000000",
            number_doc_billing: "100000000"
        }

        var openChekout = function () {
            handler.open(data)
        }
        
        </script>
    

Teniendo en cuenta sus necesidades y la arquitectura de su comercio o aplicación seleccionar uno de los siguientes métodos de integración:

variables

split_receivers

Array tipo split_receiver que contiene el id y el valor de la comisión de cada recibidor. (Si se envía el parámetro split_rule este campo se vuelve obligatorio).

El array de split_receivers está compuesto de los siguientes campos obligatorios.

b.SDK

Puede hacer uso de alguno de nuestros SDKs Disponibles:

• PHP
• RUBY
• PYTHON
• NODE
• ANDROID
• .NET

Para realizar el proceso de forma correcta debe seguir los siguientes pasos:

1. Inicializar la librería con las llaves secretas.

2. Crear Token de la tarjeta de crédito. 

3.Crear Customer con los datos del tarjetahabiente.

Split 1-1

Adicionalmente a los pasos anteriores se ejecutan los siguientes pasos para cada medio de pago.

4.Crear pago dividido con tarjeta de crédito.

5.Crear pago dividido con PSE.

6.Crear pago dividido con Efectivo.

Pagos divididos APIFY

Puede emplear cada uno de los servicios que tenemos en APIFY para realizar el procedimiento de pagos divididos según sea el medio de pago, entre estos servicios tenemos:

• Pagos divididos para PSE
• Pagos divididos para tarjeta de crédito

Después de finalizar una transacción con un botón de pago, botón de donación, link de cobro o pago divido se retornan los siguientes datos a la URL de respuesta por POST y a la URL de confirmación según el método enviado en la variable p_confirm_method.