Implementación básica

 

Cómo usar la Implementación Básica
Descripción de parámetros
Cómo probar tu servicio
IPN
IPN Descripción de parámetros

 


Cómo usar la Implementación Básica

A continuación encontrarás un código de muestra para tu botón de pago. Simplemente reemplaza los valores de ejemplo según se requiera y estarás listo para comenzar a recibir pagos.

<form name="pg_frm" method="post" action="https://www.paygol.com/pay">
 <input type="hidden" name="pg_serviceid" value="123">
 <input type="hidden" name="pg_currency" value="EUR">
 <input type="hidden" name="pg_name" value="DEMO">
 <input type="hidden" name="pg_custom" value="">
 <input type="hidden" name="pg_price" value="1">
 <input type="hidden" name="pg_return_url" value="">
 <input type="hidden" name="pg_cancel_url" value="">
 <input type="image" name="pg_button" src="https://www.paygol.com/pay-now/images/payment-button.png" border="0" alt="Realiza pagos con Paygol: la forma mas facil!" title="Realiza pagos con Paygol: la forma mas facil!" > 
</form>

Descripción de parámetros

Los siguientes parámetros POST/GET son requeridos:

Parámetro Descripción
pg_serviceid Este es el ID de servicio de tu cuenta.
pg_currency Tipo de divisa especificado en código alfabético ISO 4217 que quieres usar (Ej: EUR, USD, GBP, MXN, etc.). Ver lista completa de códigos de divisa.
pg_price El precio de tu producto, puedes modificarlo fácilmente. Si tus clientes seleccionan otro país, la divisa será convertida automáticamente.
pg_name (Opcional) Descripción de tu producto/servicio, el cual será mostrado el la pantalla de pago.
pg_custom (Opcional) Campo flexible, puede ser usado para rastrear usuario, inventario, etc.
pg_return_url (Opcional) Tus clientes serán redireccionados aquí una vez que el proceso de pago sea completado (ej: https://www.misitio.com/gracias).
pg_cancel_url (Opcional) Tus clientes serán redireccionados aquí si el proceso de pago falla o es cancelado (ej: https://www.misitio.com/cancelado).
pg_button Esta es la imagen del botón de pago. Si lo deseas, puedes reemplazarla con una propia.

Cómo probar tu servicio

En la parte superior de tu panel podrás cambiar entre los modos Test y Live. En modo Test puedes simular transacciones sin necesidad de gastar dinero real (simplemente haz click en “Continuar” y se simulará un pago exitoso).

Nótese que en el modo Test no es necesario realizar acciones externas (tales como ingresar información de tu tarjeta de crédito).

IPN

¿Qué es IPN?
Instant Payment Notification (IPN) traducido al español sería Notificación Instantánea de Pago, es un servicio de mensaje que te notifica de eventos relacionados a transacciones de Paygol. Puedes usarlo para automatizar el back-office y las funciones administrativas, tales como completar ordenes, insertar puntos o monedas, actualizar membresía, rastreo de clientes, y proveer el estado y otra información relacionada a la transacción.

Información acerca del pago
Paygol realiza una solicitud GET a tu archivo IPN cuanto tu cliente completa la transacción. Puedes usar esta notificación para finalizar y completar la orden, habilitar la descarga del material digital, información de la tienda en un CRM o en el sistema de contabilidad, etc.

¿Cómo recibir la información desde el IPN en mi página web?
Paygol provee ejemplos de código IPN para ambientes de desarrollo populares. Usa los ejemplos ya funcionando para agilizar tu integración con Paygol.

Ejemplo:

<?php 

$secret_key = "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeee";  // Enter secret key for your service. 

// Secret key validation 
if ($secret_key != $_GET['key']) {
    echo "Validation error"; 
    exit;
}

// get the variables from Paygol system
$transaction_id	 = $_GET['transaction_id'];
$service_id	     = $_GET['service_id'];
$country	        = $_GET['country'];
$custom	         = $_GET['custom'];
$price	          = $_GET['price'];
$currency	       = $_GET['currency'];

// Here you can do whatever you want with the variables, for instance inserting or updating data into your Database 

?>

IPN Descripción de parámetros

Parámetro Descripción
transaction_id El ID de la transacción.
service_id El ID de servicio de tu cuenta.
country El código de país de tu cliente especificado en ISO 3166 (Ej: EN, ES, FR, DE, etc.).
custom El campo flexible especificado en tu formulario original.
key Secret Key de tu cuenta, utilizado para validar las notificaciones de pago.
price El precio del producto de la transacción.
currency El código de moneda de la transacción (Ej: EUR, USD, GBP, MXN, etc.).
frmprice El precio original presente en el código de tu botón de pago. Puede ser usado para validación.
frmcurrency La moneda original presente en el código de tu botón de pago. Puede ser usado para validación.
method El método de pago utilizado por el pagador.

 

Implementación Premium SMS

Vista General
IPN Comenzar ahora
IPN Descripción de parámetros
IPN Uso con tus propios parámetros

 


 

Vista General

Tal como en Televisión y en muchos otros medios de comunicación puedes crear ahora tus propias campañas de marketing, encuestas, promociones, votaciones y mucho más. Puedes crear tu propia palabra clave a la cual tus usuarios enviarán mensajes de texto.

Por ejemplo: envía TEXT al 1234

Cómo funciona?
1. El usuario envía un mensaje de texto a tu palabra clave creada (por ejemplo: TEXT al 1234)
2. Un mensaje pre-definido por ti será enviado como mensaje de respuesta al usuario (por ejemplo: Gracias por tu pago)
3. Este pago será cargado a la cuenta telefónica del usuario.
4. Recibes tus ganancias y una notificación de pago será enviada a tu correo electrónico

Algunos beneficios:
– Activación inmediata.
– No requiere de sitio web ni de alguna aplicación.
– Distintos precios por cada país.
– Gran cobertura.

 

IPN

¿Qué es IPN?
Instant Payment Notification (IPN) traducido al español sería Notificación Instantánea de Pago, es un servicio de mensaje que te notifica de eventos relacionados a transacciones de Paygol. Puedes usarlo para automatizar el back-office y las funciones administrativas, tales como completar ordenes, insertar puntos o monedas, actualizar membresía, rastreo de clientes, y proveer el estado y otra información relacionada a la transacción.

Información acerca del pago
Paygol realiza una solicitud GET a tu archivo IPN cuanto tu cliente completa la transacción. Puedes usar esta notificación para finalizar y completar la orden, habilitar la descarga del material digital, información de la tienda en un CRM o en el sistema de contabilidad, etc.

¿Cómo recibir la información desde el IPN en mi página web?
Paygol provee ejemplos de código IPN para ambientes de desarrollo populares. Usa los ejemplos ya funcionando para agilizar tu integración con Paygol.

Este código de ejemplo en PHP solamente te envía un correo electrónico cada vez que un pago ha sido notificado. Por supuesto que puedes agregar tus funcionalidades propias en lugar de solamente enviar un correo electrónico.

<?php 

$secret_key = "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeee";  // Enter secret key for your service. 

// Secret key validation 
if ($secret_key != $_GET['key']) {
    echo "Validation error"; 
    exit;
}

// get the variables from Paygol system
$service_id	= $_GET['service_id'];
$shortcode	 = $_GET['shortcode'];
$keyword	   = $_GET['keyword'];
$subkeyword	= $_GET['subkeyword'];
$message	   = $_GET['message'];
$sender	    = $_GET['sender'];
$operator	  = $_GET['operator'];
$country	   = $_GET['country'];
$price	     = $_GET['price'];
$currency	  = $_GET['currency'];
 
// Here you can do whatever you want with the variables, for instance inserting or updating data into your Database 

?>
 

IPN Descripción de parámetros

 

IPN Uso con tus propios parámetros

Necesito recibir información de parte de mi cliente, ¿qué hago?
Puede que a veces necesites recibir información de parte del pagador, como por ejemplo su nombre de usuario. Nuestros servicios Premium SMS están preparados para esto y permiten al pagador agregar parámetros al final del mensaje, los cuales luego puedes utilizar para lo que requieras.

Entonces, ¿cómo funciona?
Simplemente indica a tu cliente que envíe el mensaje seguido del parámetro requerido.
Por ejemplo, digamos que las instrucciones de tu servicio Premium SMS son “Envía GOL VIP al 1234”: En este caso, si alguien envía “GOL VIP JUAN”, el parámetro GET ‘message’ contendrá “JUAN”.

¿Puedo obtener múltiples parámetros?
Por supuesto! Por ejemplo, un mensaje con el texto “GOL VIP JUAN ESPADA” retornará “JUAN ESPADA” a través del parámetro GET ‘message’.
Puedes usar incluso más parámetros de ser necesario.