Ejemplo Técnico: Botón de Pago por Redirecció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

SUBTOTAL 0%:	$ 10.00
SUBTOTAL 15%:	$ 4.00
IVA 15%:	$ 0.60
SERVICIO:	$ 0.00
PROPINA:	$ 0.00
_______________	_______________
TOTAL:	$ 14.60

DATOS DE SEGUIMIENTO

Identificador único (clientTransactionId): BR-260825-0446-1498

Motivo de transacción (reference): Prueba Boton de Pago en https://payphone.website

URL de respuesta (urlResponse): https://payphone.website/api-payphone/API-CONFIRMACION/Confirmacion.php

⚠️ ¡Atención! Formato de Montos

Todos los campos de montos deben ser enviados como un número entero que representa el valor en centavos.

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": 1460,
    "amountWithoutTax": 1000,
    "amountWithTax": 400,
    "tax": 60,
    "service": 0,
    "tip": 0,
    "currency": "USD",
    "clientTransactionId": "BR-260825-0446-1498",
    "reference": "Prueba Boton de Pago en https:\/\/payphone.website",
    "storeId": "06db3612-8a26-4853-a237-30db95008625",
    "responseUrl": "https:\/\/payphone.website\/api-payphone\/API-CONFIRMACION\/Confirmacion.php",
    "cancellationUrl": "https:\/\/payphone.website\/api-payphone\/API-CONFIRMACION\/Confirmacion.php",
    "order": {
        "billTo": {
            "address1": "Casa Tesoro",
            "address2": "Colombia",
            "country": "EC",
            "state": "Chimborazo",
            "locality": "Riobamba",
            "firstName": "Nathan",
            "lastName": "Drake",
            "phoneNumber": "+593982345678",
            "email": "ndrake@uncharted.com",
            "postalCode": "EC120101",
            "customerId": 12,
            "ipAddress": "127.0.0.1"
        },
        "lineItems": [
            {
                "productName": "Assassin Creed Ezio Collection",
                "unitPrice": 500,
                "quantity": 2,
                "taxAmount": 0,
                "totalAmount": 1000,
                "productSKU": "4342.0034",
                "productDescription": "Videojuego de Xbox One"
            },
            {
                "productName": "Sonic Frontiers Standard Edition",
                "unitPrice": 200,
                "quantity": 2,
                "taxAmount": 60,
                "totalAmount": 460,
                "productSKU": "5342.0044",
                "productDescription": "Videojuego de Nintendo Switch"
            }
        ]
    },
    "documentId": null,
    "phoneNumber": null,
    "email": null,
    "optionalParameter": "Ejemplo Técnico: Boton de Pago.",
    "timeZone": null,
    "lat": null,
    "lng": null,
    "lang": null,
    "transferTo": null
}

Fase 3: Redirección del Usuario

Respuesta Exitosa de la API de Payphone:

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

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.

📚 Documentación Técnica: BOTÓN POR REDIRECCIÓN :

💡 ¿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 de Pago por Redirección

API

BOTON DE PAGOS