.

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): TP260307-1018-5910

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

⚠️ ¡Atención! Formato de Montos

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

HEADERS

BODY (JSON Enviado):

{
    "amount": 2070,
    "amountWithoutTax": 0,
    "amountWithTax": 1800,
    "tax": 270,
    "service": 0,
    "tip": 0,
    "currency": "USD",
    "clientTransactionId": "TP260307-1018-5910",
    "reference": "Prueba Suscripcion de March 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\/ConfirmacionTokenizacion.php",
    "order": {
        "billTo": {
            "address1": "Midgar Sector 7",
            "address2": "Gaia",
            "country": "EC",
            "state": "Carchi",
            "locality": "Tulcán",
            "firstName": "Cloud",
            "lastName": "Strife",
            "phoneNumber": "+593988877766",
            "email": "cloud@finalfantasy.com",
            "postalCode": "EC600101",
            "customerId": 16,
            "ipAddress": "127.0.0.1"
        },
        "lineItems": [
            {
                "productName": "Suscripción Disney Plus",
                "unitPrice": 1800,
                "quantity": 1,
                "totalAmount": 2070,
                "taxAmount": 270,
                "productSKU": "1642.0094",
                "productDescription": "Suscripción Mensual"
            }
        ]
    },
    "documentId": null,
    "phoneNumber": null,
    "email": null,
    "optionalParameter": 16,
    "lat": null,
    "lng": null,
    "lang": "es",
    "transferTo": null
}

Fase 3: Redirección del Usuario

Respuesta Exitosa de la API de Payphone:

{
    "paymentId": "ab8weAc8tE6wuhortRHCg",
    "payWithPayPhone": "https:\/\/pay.payphonetodoesposible.com\/PayPhone\/Index?paymentId=ab8weAc8tE6wuhortRHCg&lang=es",
    "payWithCard": "https:\/\/pay.payphonetodoesposible.com\/Anonymous\/Index?paymentId=ab8weAc8tE6wuhortRHCg&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 Tokenización

⚠️ 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: