Ejemplo Técnico: Botón de Pago con Split

Fase 1: Preparación de la Dispersión

Antes de iniciar la integración, asegúrate de preparar los datos de tu transacción.

Y preparar los actores a los cuales se dividira el cobro.

MONTOS

SUBTOTAL 0%:	$ 2.00
SUBTOTAL 15%:	$ 38.00
IVA 15%:	$ 5.70
SERVICIO:	$ 0.00
PROPINA:	$ 0.00
_______________	_______________
TOTAL:	$ 45.70

DATOS DE SEGUIMIENTO

Identificador único (clientTransactionId): SP260521-1840-0327

Motivo de transacción (reference): Prueba Boton con Split May 2026

Actores para Split de pagos

Para implementar el split de pagos: Se debe crear un arreglo que contenga los usuarios Payphone a los cuales se dividira el pago. Indicar los valores que recibira cada usuario, el tipo: si es business 3 o personal 4 y su respectivo identificador. El valor que se dividirá entre usuarios Payphone no debe sobrepasar el monto total a cobrar y se debe tener en cuenta el valor de comisión del servicio (5.75%): $2.63

[
    {
        "Identifier": "17XXXXXXXX001",
        "Type": 3,
        "Amount": 3656
    },
    {
        "Identifier": "+593984XXXXXX",
        "Type": 4,
        "Amount": 651
    }
]

Este arreglo se debe codificar en AES 256 CBC sin vector de inicialización

transferTo: YctgHqo7RoaG0ibIGfLfAOUCFSjhwJLTgh5poUY9XARFdWFb5a0tplifDIHE250Jbkj1AeSdOAgg1LNRVkY88tfFNxcG6F+kxjQ9EyH7rVZTNYFDbokHf5KRbm1hY7GgI4VQtVzB7/+P9/FD4ApOVw==

Fase 2: Solicitud API - Creación del Botón de Pagos :

Método: POST URL del Endpoint: https://pay.payphonetodoesposible.com/api/button/Prepare

HEADERS

Content-Type: application/json Authorization: bearer SU_TOKEN

BODY (JSON Enviado):

{
    "amount": 4570,
    "amountWithoutTax": 200,
    "amountWithTax": 3800,
    "tax": 570,
    "service": 0,
    "tip": 0,
    "currency": "USD",
    "clientTransactionId": "SP260521-1840-0327",
    "reference": "Prueba Boton con Split May 2026",
    "storeId": "99c14ad3-c9f8-466e-b73f-609e39284538",
    "responseUrl": "https:\/\/www.payphone.website\/api-payphone\/API-CONFIRMACION\/ConfirmacionSplit.php",
    "cancellationUrl": "https:\/\/www.payphone.website\/api-payphone\/API-CONFIRMACION\/ConfirmacionSplit.php",
    "order": {
        "billTo": {
            "address1": "UNSC Infinity",
            "address2": "Espacio",
            "country": "EC",
            "state": "Manabí",
            "locality": "Manta",
            "firstName": "Master",
            "lastName": "Chief",
            "phoneNumber": "+593981234567",
            "email": "mchief@halo.com",
            "postalCode": "EC200101",
            "customerId": 11,
            "ipAddress": "127.0.0.1"
        },
        "lineItems": [
            {
                "productName": "Horizon Forbidden West",
                "unitPrice": 100,
                "quantity": 2,
                "totalAmount": 200,
                "taxAmount": 0,
                "productSKU": "3342.0014",
                "productDescription": "Videojuego de Playstation 4"
            },
            {
                "productName": "Nintendo Switch Deluxe",
                "unitPrice": 1900,
                "quantity": 2,
                "totalAmount": 4370,
                "taxAmount": 570,
                "productSKU": "5342.0064",
                "productDescription": "Consola de Videojuegos"
            }
        ]
    },
    "documentId": null,
    "phoneNumber": null,
    "email": null,
    "optionalParameter": null,
    "lat": null,
    "lng": null,
    "lang": "es",
    "transferTo": "YctgHqo7RoaG0ibIGfLfAOUCFSjhwJLTgh5poUY9XARFdWFb5a0tplifDIHE250Jbkj1AeSdOAgg1LNRVkY88tfFNxcG6F+kxjQ9EyH7rVZTNYFDbokHf5KRbm1hY7GgI4VQtVzB7\/+P9\/FD4ApOVw=="
}

Fase 3: Redirección del Usuario

Respuesta Exitosa de la API de Payphone:

{
    "paymentId": "Ga5PmFm8H0G6ZvwA6bUlw",
    "payWithPayPhone": "https:\/\/pay.payphonetodoesposible.com\/PayPhone\/Index?paymentId=Ga5PmFm8H0G6ZvwA6bUlw&lang=es",
    "payWithCard": "https:\/\/pay.payphonetodoesposible.com\/Anonymous\/Index?paymentId=Ga5PmFm8H0G6ZvwA6bUlw&lang=es"
}

Interface para cliente:

Una vez que recibes la respuesta de la API, debes presentar al usuario las opciones de pago como botones que, al ser clickeados, redirijan al usuario a los formularios de pago de Payphone.

Cajita de Pago con Split

📚 Documentación Técnica: SPLIT DE PAGO

💡 ¿Necesitas más información sobre la integración del botón de pago?

Consulta la documentación oficial para conocer todos los detalles, parámetros disponibles, estructuras de respuesta y buenas prácticas:

Guía de Integración: Botón con Split

API

BOTON CON SPLIT

Ejemplo Técnico: Botón de Pago con Split

Fase 1: Preparación de la Dispersión

MONTOS

DATOS DE SEGUIMIENTO

Identificador único (clientTransactionId): SP260521-1840-0327

Motivo de transacción (reference): Prueba Boton con Split May 2026

Actores para Split de pagos

transferTo: YctgHqo7RoaG0ibIGfLfAOUCFSjhwJLTgh5poUY9XARFdWFb5a0tplifDIHE250Jbkj1AeSdOAgg1LNRVkY88tfFNxcG6F+kxjQ9EyH7rVZTNYFDbokHf5KRbm1hY7GgI4VQtVzB7/+P9/FD4ApOVw==

Fase 2: Solicitud API - Creación del Botón de Pagos :

HEADERS

BODY (JSON Enviado):

Fase 3: Redirección del Usuario

Respuesta Exitosa de la API de Payphone:

Interface para cliente:

Cajita de Pago con Split

📚 Documentación Técnica: SPLIT DE PAGO

Acerca de Payphone

Contactos

Paginas Principales

BOTON CON SPLIT

Ejemplo Técnico: Botón de Pago con Split

Fase 1: Preparación de la Dispersión

MONTOS

DATOS DE SEGUIMIENTO

Identificador único (clientTransactionId): SP260521-1840-0327

Motivo de transacción (reference): Prueba Boton con Split May 2026

Actores para Split de pagos

transferTo: YctgHqo7RoaG0ibIGfLfAOUCFSjhwJLTgh5poUY9XARFdWFb5a0tplifDIHE250Jbkj1AeSdOAgg1LNRVkY88tfFNxcG6F+kxjQ9EyH7rVZTNYFDbokHf5KRbm1hY7GgI4VQtVzB7/+P9/FD4ApOVw==

Fase 2: Solicitud API - Creación del Botón de Pagos :

HEADERS

BODY (JSON Enviado):

Fase 3: Redirección del Usuario

Respuesta Exitosa de la API de Payphone:

Interface para cliente:

Cajita de Pago con Split

Cajita de Pago en Modal

📚 Documentación Técnica: SPLIT DE PAGO

Acerca de Payphone

Contactos

Paginas Principales