.

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

Fase 1: Preparación de la Transacción

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

MONTOS

DATOS DE SEGUIMIENTO

Identificador único (clientTransactionId): TP-260825-1216-1148

Motivo de la transacción (reference): Prueba Suscripcion de August 2026

⚠️ ¡Atención! Formato de Montos

Cajita de Pago con Tokenización

Redirección del Usuario

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.

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

HEADERS

BODY (JSON Enviado):

{
    "amount": 1265,
    "amountWithoutTax": 0,
    "amountWithTax": 1100,
    "tax": 165,
    "service": 0,
    "tip": 0,
    "currency": "USD",
    "clientTransactionId": "TP-260825-1216-1148",
    "reference": "Prueba Suscripcion de August 2026",
    "storeId": "99c14ad3-c9f8-466e-b73f-609e39284538",
    "responseUrl": "https:\/\/payphone.website\/api-payphone\/API-CONFIRMACION\/ConfirmacionTokenizacion.php",
    "cancellationUrl": "https:\/\/payphone.website\/api-payphone\/API-CONFIRMACION\/Confirmacion.php",
    "order": {
        "billTo": {
            "address1": "Mansion Arklay",
            "address2": "Raccoon City",
            "country": "EC",
            "state": "Guayas",
            "locality": "Guayaquil",
            "firstName": "Jill",
            "lastName": "Valentine",
            "phoneNumber": "+593984102030",
            "email": "jvalentine@residentevil.com",
            "postalCode": "040108",
            "customerId": 4,
            "ipAddress": "127.0.0.1"
        },
        "lineItems": [
            {
                "productName": "Suscripción Netflix",
                "unitPrice": 1100,
                "quantity": 1,
                "totalAmount": 1265,
                "taxAmount": 165,
                "productSKU": "1442.0094",
                "productDescription": "Suscripción Mensual"
            }
        ]
    },
    "documentId": null,
    "phoneNumber": null,
    "email": null,
    "optionalParameter": 14,
    "timeZone": null,
    "lat": null,
    "lng": null,
    "lang": null,
    "transferTo": null
}

Fase 3: Redirección del Usuario

Respuesta Exitosa de la API de Payphone:

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

⚠️ Recordatorio

Las tarjetas Diners Club y Discover no son compatibles con este método.

📚 Documentación Técnica: TOKENIZACIÓN

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