.

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-1019-1540

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": 1725,
    "amountWithoutTax": 0,
    "amountWithTax": 1500,
    "tax": 225,
    "service": 0,
    "tip": 0,
    "currency": "USD",
    "clientTransactionId": "TP260307-1019-1540",
    "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": "Mansión Croft",
            "address2": "Londres",
            "country": "EC",
            "state": "Tungurahua",
            "locality": "Ambato",
            "firstName": "Lara",
            "lastName": "Croft",
            "phoneNumber": "+593983456789",
            "email": "lara.croft@tombraider.com",
            "postalCode": "EC100101",
            "customerId": 10,
            "ipAddress": "127.0.0.1"
        },
        "lineItems": [
            {
                "productName": "Suscripción Netflix",
                "unitPrice": 1500,
                "quantity": 1,
                "totalAmount": 1725,
                "taxAmount": 225,
                "productSKU": "1442.0094",
                "productDescription": "Suscripción Mensual"
            }
        ]
    },
    "documentId": null,
    "phoneNumber": null,
    "email": null,
    "optionalParameter": 14,
    "lat": null,
    "lng": null,
    "lang": "es",
    "transferTo": null
}

Fase 3: Redirección del Usuario

Respuesta Exitosa de la API de Payphone:

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