Boton de pago
Cajita de pagos | RecomendadoBotón de pago por redirecciónTokenizaciónSplit de Pagos
Plugins
WoocommercePrestashop
APIs
Links de PagoAPI SalePagos MasivosWebViewNotificación ExternaAPI UserConsulta por LotesPre-registro de comercios
Soporte
visita payphone.app
  • 🔹📎 ¿Cómo funciona el api users?

  • 🔹🛡️ Proceso de Autorización

  • 🔹🔑 Configuración del ambiente

  • 🔹🛠️ Guía de Integración: API Users

Consultar Detalle de Usuario Payphone

📎¿Cómo funciona el api users?

La consulta del detalle de usuarios Payphone es una funcionalidad que permite comprobar la información de  un usuario registrado en el sistema Payphone. Para hacer esto, se realiza una solicitud HTTP GET al API de Payphone, proporcionando el número de teléfono (con el prefijo "0") y el código de país correspondiente.

🔄Flujo de la consulta de usuarios

  1. Realiza una solicitud HTTP GET al endpoint con el número de teléfono personal y el código de país de la región.
  2. La API devuelve la información del usuario registrado en Payphone.
  3. La API responde un JSON con el detalle del usuario registrado.

⚠️Consideraciones Importantes: ¡Puntos Clave a Tener en Cuenta!

  • El número de teléfono debe incluir el cero inicial (por ejemplo, 0984112233).
  • El código de país debe ser válido.
  • Se debe incluir un token de autenticación tipo API en la cabecera de la solicitud.
  • Se requiere una Autorización para poder tener acceso al servicio de consulta.

🛡️Proceso de Autorización para Consulta de Usuarios

El acceso al servicio de Consulta del detalle de usuarios Payphone requiere una autorización previa. A continuación, se detalla el proceso:

✉️ Solicitud de Autorización:

Para iniciar el proceso, el comercio debe enviar un correo electrónico a nuestra area comercial de Payphone con la siguiente información:

📨 Correo electrónico de contacto: Las solicitudes pueden enviarse a requests.docs@payphone.app

  1. Asunto: Activación de la funcionalidad: Consulta del detalle de usuarios Payphone
  2. Identificador del comercio: RUC, Cédula de Identidad
  3. Nombre del comercio
  4. Giro de Negocio: la actividad o conjunto de actividades principales que realiza la empresa para generar ingresos.
  5. Motivo detallado de la solicitud: Explicar el uso que se le dará al servicio y los beneficios que aportará al negocio.
  6. Información de contacto del solicitante: Nombre completo, número de teléfono y correo electrónico.
🔍Revisión y Evaluación por el Agente Comercial:

El agente comercial de Payphone revisará cuidadosamente la solicitud, analizando los siguientes aspectos:

  1. Viabilidad comercial: Se evaluará si el servicio solicitado se alinea con la estrategia y los objetivos de Payphone.
  2. Riesgos: Se identificarán y evaluarán los posibles riesgos asociados con la activación del servicio, como riesgos de seguridad o fraude.
  3. Investigación adicional: El agente comercial podrá solicitar información adicional al cliente si es necesario para completar el análisis.
  4. Reuniones: El agente comercial podrá programar reuniones con el cliente para discutir la solicitud en detalle y aclarar cualquier duda.

🏢Validación del Comercio:

Payphone realizará una verificación exhaustiva de la información del comercio, incluyendo:

  1. Verificación de identidad: Se verificará la identidad del comercio y sus representantes.
  2. Datos de contacto: Se validarán los datos de contacto proporcionados.
  3. Actividad comercial: Se analizará la actividad comercial del comercio.
  4. Evaluación de riesgos: Se evaluarán los riesgos asociados al comercio, como riesgo crediticio o riesgo de fraude.
  5. Cumplimiento normativo: Se verificará que el comercio cumple con todas las regulaciones y normativas aplicables.
  6. Firma de acuerdos: Se firmarán acuerdos de responsabilidad entre Payphone y el comercio para formalizar la relación.
✅Aprobación de la Solicitud:
  1. Autorización: Una vez que el comercio haya sido validado y se hayan obtenido las aprobaciones internas, el agente comercial autorizará el uso del servicio de Consulta del detalle de usuarios Payphone.
  2. Activación: El área técnica de Payphone procederá a activar el servicio para el cliente.
  3. Notificación: Se notificará al cliente que el servicio ha sido activado y se le proporcionarán las instrucciones de uso.
📡Seguimiento y Monitoreo:
  1. Monitoreo continuo: Payphone realizará un seguimiento continuo del uso del servicio para asegurar su correcto funcionamiento y detectar posibles problemas.
  2. Soporte: Se brindará soporte técnico al cliente en caso de cualquier inconveniente.

🔑Configuración del Ambiente y Obtención de Credenciales

¡Prepara tu plataforma para recibir pagos de forma segura, fácil y eficiente con Payphone! 🛒💳 Sigue estos pasos y empieza a procesar transacciones en minutos:

🚀 Lo primero es configurar tu ambiente

Para que Payphone funcione correctamente, necesitas establecer una conexión segura entre tu sistema y nuestra plataforma.

Esto incluye obtener dos credenciales clave:

Token y StoreID


🛠️ ¿Cómo hacerlo?

  1. Configura tu API. Desde tu cuenta de Payphone Developer asegúrate de haber creado una aplicación de tipo: "API"
  2. Obtén tus credenciales. Estos datos son esenciales para autenticarte con Payphone. Encuéntralos al configurar tu aplicación.
  3. Establece tu entorno de desarrollo y pruebas. Esto te permitirá realizar simulaciones antes de pasar a la producción.

🎯 ¿Por qué es importante?

  1. Seguridad: Tus transacciones estarán encriptadas y protegidas contra accesos no autorizados.
  2. Personalización: Adapta los métodos de pago según las necesidades de tu negocio.
  3. Funcionalidad: Garantiza que los pagos se procesen correctamente.


✨ ¡Comienza ahora!

Haz clic en el siguiente botón, sigue las instrucciones para obtener tus credenciales:


📑 Configuración de Ambiente y Obtención de Credenciales


⚠️NOTA:

👉 Sin esta configuración, no podrás procesar pagos a través de nuestra plataforma.

🛠️Guía de Integración: API Users

🧩API Users/{id payphone}/region/{código país}

Este método te permite consultar la información de un usuario registrado en Payphone Personal. Para utilizar el método Users, debes realizar una solicitud GET a la siguiente URL:

URL de la solicitud GET:

https://pay.payphonetodoesposible.com/api/Users/0984112233/region/593
  • {id Payphone Personal}: El número de teléfono del usuario catalogado como id de Payphone Personal (debe incluir el cero inicial, ejemplo: 0984112233).
  • {código País}: El código del país correspondiente al número de teléfono (por ejemplo, para Ecuador, el código sería 593).

🔐Cabeceras Requeridas

Se debe incluir las siguientes cabeceras HTTP:

  • Authorization: bearer TU_TOKEN (Token de autenticación de la aplicación, precedido por la palabra "Bearer". )
  • Content-type: application/json (Formato de los datos: JSON).

📬Respuesta a la solicitud GET

  • ✅Respuesta exitosa: Si el número de teléfono está registrado en Payphone, la respuesta será un JSON con la información del usuario de Payphone
{
    "documentId": "1234567890",
    "name": "ELISABETH",
    "lastName": "SOBECK",
    "email": "aloy@mail.com",
    "phoneNumbers": [
        "********1333"
    ]
}
  • ❌Respuesta fallida: Si el número de teléfono NO está registrado en Payphone, la respuesta será un JSON con el mensaje "Lo sentimos, este número no está registrado en Payphone"
{
    "message": "Lo sentimos, este número no está registrado en Payphone",
    "errorCode": 120
}

🧱 Ejemplos de solicitudes GET para API Users

A continuación, se presenta varios ejemplos de cómo realizar solicitudes GET:

PHP
JQUERY
FETCH
<?php
    //Funcion q ejecuta una solicitud http GET
    function curlGet($urlAPI, $headers) {
        //Iniciar solicitud curl: GET 
        $curl = curl_init();        
        curl_setopt($curl, CURLOPT_URL, $urlAPI);
        curl_setopt($curl, CURLOPT_HEADER, 0);
        curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
        //Respuesta en formato JSON
        $curl_response = curl_exec($curl);
        //Finaliza solicitud curl: GET
        curl_close($curl);
        return json_decode($curl_response);
    }
    /*## Preparar informacion del usuario Payphone ##*/    
    $phoneNumber = "0984111333";//ID Payphone Personal.
    $countryCode = "593";//Código de país.

    $token="your_token_API";
    $url="https://pay.payphonetodoesposible.com/api/Users/".$phoneNumber."/region/".$countryCode;
    //Preparar cabecera para la solicitud
    $headers[] = 'Authorization: Bearer '.$token ;//CREDENCIALES DE CONFIGURACION
    $headers[] = 'Content-Type: application/json' ;//TIPO DE APLICACION     

    //realizar solicitud http GET
    $result=curlGet($url, $headers);

    //Mostrar Resultado en Pantalla
    echo "<h1>Usuario Registrado</h1>";    
    echo "<a>Usuario Payphone:<strong>".$phoneNumber."<strong></a><br>";
    echo "Respuesta : <pre>".json_encode($result,JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT )."</pre>";
?>
<html lang="es">
    <head>
        <meta charset="utf-8">
        <title>Usuario Registrado</title>
        <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>   

    </head>    
    <body>
        <h1>Usuario Registrado</h1>
        <a>Usuario Payphone: <strong id="phoneNumber"></strong></a><br>
        <div id="resultado"></div>
        <script>
            /*## Preparar credenciales como variables para la solicitud ##*/
            const token="your_token_API";

            /*## Preparar informacion del usuario Payphone ##*/
            const phoneNumber="0984111333"; //ID Payphone Personal.
            const countryCode="593"; //Codigo Pais

            $(document).ready(function() {
                $.ajax({
                    url: "https://pay.payphonetodoesposible.com/api/Users/"+phoneNumber+"/region/"+countryCode,
                    type: "GET",
                    headers: {
                    "Content-Type": "application/json",
                    "Authorization": "Bearer "+token
                    },
                    success: function(response) {
                        $("#resultado").html(
                            "Respuesta : <pre>" + JSON.stringify(response, null, 2) + "</pre>"
                        );
                    },
                    error: function(error) {
                        $("#resultado").html(
                            "Error en la solicitud : <pre>" + JSON.stringify(error, null, 2) + "</pre>"
                        );
                    }
                });
            });

            // Mostrar en pantalla datos relevantes            
            document.getElementById("phoneNumber").innerHTML=phoneNumber;
        </script>
    
    </body>
</html>
<html lang="es">
    <head>
        <meta charset="utf-8">
        <title>Usuario Registrado</title> 
    </head>    
    <body>
        <h1>Usuario Registrado</h1>
        <a>Usuario Payphone: <strong id="phoneNumber"></strong></a><br>
        <a>Respuesta: </a><br>
        
        <script>   
            /*## Preparar credenciales como variables para la solicitud ##*/
            const token="your_token_API";

            const  headers = {
                "Content-Type": "application/json",
                "Authorization": "Bearer "+token                
            };
            /*## Preparar informacion del usuario Payphone ##*/
            const phoneNumber="0984111333"; //ID Payphone Personal.
            const countryCode="593"; //Codigo Pais

            /*## Preparar informacion para la solicitud GET ##*/
            //URL del servicio payphone
            const  url = "https://pay.payphonetodoesposible.com/api/Users/"+phoneNumber+"/region/"+countryCode;

            fetch(url, {
                method: "GET",
                headers: headers
            })
            .then((res) => res.json())
            .catch((error) => {
                // Creamos las etiquetas <a>
                const jsonResult = document.createElement("pre");
                jsonResult.textContent = JSON.stringify(error, null, 2);

                // Mostrar los enlaces en el documento con un salto de línea entre ellos
                const container = document.createElement("div");
                container.appendChild(jsonResult);

                // Agregar los enlaces al body del documento o a un contenedor específico
                document.body.appendChild(container);
            })
            .then((data) => {

                // Creamos las etiquetas <a>
                const jsonResult = document.createElement("pre");
                jsonResult.textContent = JSON.stringify(data, null, 2);

                // Mostrar los enlaces en el documento con un salto de línea entre ellos
                const container = document.createElement("div");
                container.appendChild(jsonResult);

                // Agregar los enlaces al body del documento o a un contenedor específico
                document.body.appendChild(container);
            });  
            // Mostrar en pantalla datos relevantes            
            document.getElementById("phoneNumber").innerHTML=phoneNumber;
        </script>
    </body>
</html>
Videos tutorialesPolíticas de privacidadTérminos y condiciones
Copyright © 2024 Payphone | Todos los derechos reservados | Términos y condiciones