Links de pago

¿Cómo funciona el link de pago?

El link de pago es una solución del ecosistema Payphone que te permite recibir pagos sin necesidad de una página web, solo enviando un link a tus clientes. Si quieres vender por Facebook, Instagram, WhatsApp o email, el link de pago es tu solución.

También es ideal para cobros de cartera por email y pagos asíncronos. El Link de pago puedes generarlo desde tu página PayPhone Business o haciendo una integración tecnológica con nuestro Api. A continuación te mostraremos cómo generar un Link de pago desde nuestra página de Payphone Business, y después con nuestro Api si requieres hacer una integración con tu sistema.

Flujo del Link de pago

El link de pago funciona de la siguiente forma:

Generar link de pago con un valor a cobrar especifico.
Enviar link de pago al cliente.
El cliente realiza el pago

Generar Link de pago desde el portal Payphone Business

Ingresa en tu portal PayPhone Business con tu Ruc, correo y clave, y dirígete a la sección «Generar Link de pago»

A continuación ingresa el monto a cobrar y presiona «Generar link de pago»

Automáticamente se generará un link que puedes compartir por el medio de tu preferencia, y adicionalmente tendrás un código QR (la persona que lo escanee abrirá el link de pago)

Cuando tu cliente abra el link podrá pagar usando su tarjeta de crédito o débito, o usar su app de Payphone para pagar con tarjetas de regalo o saldo Payphone. El link se ve de la siguiente forma:

Generar links de pago mediante Api

La integración con el Api permite un control más directo sobre las transacciones dando la facilidad de poner fechas máximas de uso o limitar su consumo a una sola vez. Con el consumo del Api puedes generar link personalizados, por ejemplo, un colegio puede generar un link para cada alumno y llevar un control directo sobre los pagos de matriculas o pensiones y un mejor cobro de cartera.

Sigue los siguientes pasos para generar un link desde nuestro Api:

Requisitos Comerciales:

El establecimiento que va a recibir los pagos tiene que estar registrado en Payphone Business. Para iniciar el registro puedes hacer click aquí.
Con la tienda activa y lista para transaccionar, debes crear un usuario de tipo “desarrollador“, el cual te explicaremos más adelante.

Requisitos de Desarrollo:

Debes configurar en nuestro sitio web para desarrolladores «Payphone Developer» tu ambiente de desarrollo en donde podrás obtener todas tu token de autenticación con el que te identificas en los servicios de Payphone.

Crear usuario desarrollador

Ingresa en tu página Payphone Business, e inicia sesión con el ruc, correo y contraseña, (si no tienes acceso, el administrador de la empresa puede entrar y crear tu usuario) y dirígete a la sección de «Usuarios» a continuación selecciona «Crear Usuario»:

Ingresa todos los datos del desarrollador en el formulario, no olvides que en el campo «Roles» debes ingresar «Desarrollador». (El administrador debe entregarel correo electrónico y la contraseña ingresadas)

Con este proceso listo, el usuario desarrollador puede iniciar la implementación.

Página Payphone Developer

Configurar el ambiente de desarrollo te permite tener un control total sobre las transacciones efectuadas a través de Payphone. Por favor sigue los siguientes pasos:

1. Iniciar sesión como desarrollador

Ingresa en la página https://appdeveloper.payphonetodoesposible.com/ e inicia sesión con las credenciales de tu usuario desarrollador (Ruc, correo y contraseña).

2. Crear Aplicación Payphone:

Las aplicaciones de desarrollo Payphone te permiten configurar tu ambiente de pruebas, parámetros de conexión o usuarios de test, y te ayuda a obtener tus credenciales de autenticación como el token.

Para crear tu aplicación haz click en el “+” de la parte superior:

Se abrirá un formulario donde debes ingresar los campos de tu aplicación el tipo de aplicación debe ser API

Presiona Guardar

Obtener Token de autenticación

Con la aplicación configurada debes hacer click el menú superior en la pestaña credenciales, y tendrás el botón para copiar tu token..

Llamada al servicio

Con los requisitos listos, debes hacer una llamada POST indicando en la cabecera tu token de tipo «Authorization» con contenido “Bearer TUTOKEN”. La llamada debe ser a la url: https://pay.payphonetodoesposible.com/api/Links con un objeto del tipo Json que cuente con los siguientes parámetros:

Nombre	Descripción	Tipo de dato	Opcional
amount	Valor total de la factura a cobrar, es la suma de amountWithTax, amountWithoutTax, Tax, service y tip.	Int
amountWithoutTax	Valor que no graba impuesto.	Int	X - solo en caso de que se cobre valores con Iva, es obligatorio si no se cobran valores con Iva
amountWithTax	Valor que si graba impuesto, sin el impuesto incluido.	Int	X - solo en caso de que se cobre valores sin Iva, es obligatorio si se cobran valores con Iva
tax	Valor del impuesto.	Int	X - solo en caso de que se cobre valores sin Iva, es obligatorio si se cobran valores con Iva
service	Valor del servicio.	Int	X
tip	Valor de la propina.	Int	X
currency	Moneda a cobrar. /ej USD	String	X
clientTransactionId	Identificador de transacción, debes generarlo, es un identificador único.	String
storeId	Identificador de sucursalr que realiza el cobro, este parámetro se puede obtener en el apartado "Solicitud de compañia" de la página de PayPhone Developer, en el botón lista.	String	X
reference	Referencia del pago que puedes enviar.	String	X
oneTime	Campo para controlar si el link funciona solo una vez: True si el link se usa solo una vez, false si se usa varias veces.	Boolean	X
expireIn	Número de horas en que estará disponible el link de pago.	Integer	X

Ejemplos de Json método links:

Generar link de pago de $1.12, donde $1 dólar es el subtotal y $0.12 los impuestos:

				
					{
"amount": 112,
"tax": 12,
"amountWithTax": 100,
"clientTransactionId": "idlink001",
"currency": "USD"
}

Generar link de pago de $1 dólar sin impuestos.

				
					{
"amount": 100,
"amountWithoutTax": 100,
"clientTransactionId": "idlink001",
"currency": "USD"
}

Estos son los objetos base pero te recomendamos enviar la mayor cantidad de datos para que tengas mejor control.

La respuesta de la petición POST del método LINKS es la url que contiene el link de pago.

¡Listo!, esos son todos los pasos para generar links de pago. Recuerda que con el Api solo puedes consumir hasta 20 veces por minuto.

Sabias que...