Ejemplo Técnico: Cobro al app de Payphone

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%:	$ 1.24
SUBTOTAL 15%:	$ 0.49
IVA 15%:	$ 0.07
SERVICIO:	$ 0.00
PROPINA:	$ 0.00
_______________	_______________
TOTAL:	$ 1.80

DATOS DE USUARIO DE PAYPHONE PERSONAL

Número de Celular (phoneNumber): 0984XXXXXX

Código de País (countryCode): 593

DATOS DE SEGUIMIENTO

Identificador único (clientTransactionId): SA260825-2106-4147

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

⚠️ ¡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 Sale - Cobro al app de Payphone:

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

HEADERS

Content-Type: application/json Authorization: bearer SU_TOKEN

BODY (JSON Enviado):

{
    "phoneNumber": "0984XXXXXX",
    "countryCode": "593",
    "amount": 180,
    "amountWithoutTax": 124,
    "amountWithTax": 49,
    "tax": 7,
    "service": 0,
    "tip": 0,
    "reference": "Prueba API Sale en https:\/\/payphone.website",
    "clientTransactionId": "SA260825-2106-4147",
    "currency": "USD",
    "storeId": "38bd09ea-df9f-4402-abc1-47e3b344edb8",
    "order": {
        "billTo": {
            "address1": "Jackson",
            "address2": "Wyoming",
            "country": "EC",
            "state": "Pichincha",
            "locality": "Quito",
            "firstName": "Joel",
            "lastName": "Miller",
            "phoneNumber": "+593984556688",
            "email": "jmiller@lastofus.com",
            "postalCode": "EC170108",
            "customerId": 2,
            "ipAddress": "127.0.0.1"
        },
        "lineItems": [
            {
                "productName": "Mascarilla RZ7",
                "unitPrice": 75,
                "quantity": 1,
                "totalAmount": 75,
                "taxAmount": 0,
                "productSKU": "2342.0094",
                "productDescription": "Mascarilla contra el bicho"
            },
            {
                "productName": "Pepsi Cero",
                "unitPrice": 49,
                "quantity": 1,
                "totalAmount": 56,
                "taxAmount": 7,
                "productSKU": "1842.0017",
                "productDescription": "Pepsi Cero"
            },
            {
                "productName": "Doritos Hot",
                "unitPrice": 49,
                "quantity": 1,
                "totalAmount": 49,
                "taxAmount": 0,
                "productSKU": "1842.0022",
                "productDescription": "Doritos Hot"
            }
        ]
    },
    "chargeByNickName": false,
    "nickName": null,
    "responseUrl": null,
    "optionalParameter1": null,
    "optionalParameter2": null,
    "optionalParameter3": null,
    "timeZone": 0,
    "lat": null,
    "lng": null,
    "clientUserId": null
}

Fase 3: Identificador de Transacción

Respuesta Exitosa de la API de Payphone:

{
    "transactionId": 53193958
}

Consulta De Estado:

Una vez que recibes la respuesta de la API, puedes obtener el detalla de la transaccion utilizando nuestros servicios de consulta:

Consultar por transactionId: api/Sale/{transactionId}

Consultar por clientTransactionId: api/Sale/client/{clientTransactionId}

Uso del campo responseUrl (Webhook)

Si configuras el campo responseUrl en la solicitud inicial, nuestro servidor enviará dos parámetros a esa URL:

id: Identificador de la transacción.

clientTransactionID: Identificador de la transacción proporcionado por el comercio.

Prueba nuestro servicio API Sale

Ingresa un número telefonico valido registrado en Payphone Personal.

Datos de Usuario
Codigo de Pais:
Numero Celular:

📚 Documentación Técnica: Cobro al app de Payphone :

💡 ¿Necesitas más información sobre la integración con API Sale?

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: API Sale

API

API SALE