Vista General
Cómo usar la Implementación Avanzada
Descripción de parámetros
IPN
IPN Descripción de parámetros
Vista General
Nuestra implementación avanzada es una solución de pagos white label que te permite redirigir a tus clientes directamente a un método de pago local sin necesidad de pasar por la pantalla de pago de Paygol.
Cómo usar la implementación avanzada
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_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="hidden" name="pg_mode" value="advanced"> <input type="hidden" name="pg_country" value="GB"> <input type="hidden" name="pg_method" value="creditcard"> Email: <input type="text" name="pg_email"><br><br> Nombre: <input type="text" name="pg_first_name"><br><br> Apellido: <input type="text" name="pg_last_name"><br><br> Personal ID: <input type="text" name="pg_personalid"><br><br> <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:
| Nombre | Descripción |
| pg_serviceid | 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 | Precio de tu servicio, puedes modificarlo fácilmente. Si tus clientes seleccionan otro país, la divisa será convertida automáticamente. |
| 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 | Imagen del botón de pago. Si lo deseas, puedes reemplazarla con una propia. |
| pg_mode | Debe tener el valor “advanced” para activar el modo de implementación avanzada. |
| pg_country | País del pagador, en formato ISO 3166-2 (ej: GB, DE, ES). |
| pg_language | Idioma, en formato ISO 639-1 (ej: es, en). Si el idioma proporcionado no está disponible, utiliza inglés por defecto. |
| pg_method | Método de pago. Favor de revisar la tabla que se presenta a continuación para una lista de métodos disponibles y sus códigos. Para más información referente a cada método de pago, visita nuestra página de Costos. |
| pg_email | Dirección de correo electrónico del pagador. |
| pg_first_name | Nombre del pagador. |
| pg_last_name | Apellido del pagador. |
| pg_personalid | Número de identificación local del pagador. Sólo es requerido por algunos métodos de pago locales. |
Códigos de los métodos de pago disponibles:
| Nombre | Código | Descripción |
| Credit Card | creditcard | Pagos con tarjeta de crédito. |
| Bitcoin | bitcoin | Pagos con bitcoin. |
| WebPay | webpay | Pagos con tarjetas de débito y crédito en Chile mediante WebPay. |
| Paysafecard | paysafecard | Pagos con Paysafecard. |
| Giropay | giropay | Pagos mediante Giropay. |
| iDEAL | ideal | Pagos mediante iDEAL. |
| Sofort | sofort | Pagos mediante Sofort. |
| Przelewy24 | przelewy24 | Pagos mediante Przelewy24. |
| Bancontact | bancontact | Pagos mediante Bancontact. |
| Caixa | caixa | Pagos mediante transferencia bancaria electrónica en Brasil mediante Caixa. |
| Bradesco | bradesco | Pagos mediante transferencia bancaria electrónica en Brasil mediante Bradesco. |
| OXXO | oxxo | Pagos en efectivo en México mediante Oxxo. |
| Itau | itau | Pagos mediante transferencia bancaria electrónica mediante Itau. |
| Davivienda | davivienda | Pagos en efectivo en Colombia mediante Davivienda. |
| Boleto | boleto | Pagos en efectivo en Brasil mediante Boleto. |
| Redpagos | redpagos | Pagos en efectivo en Uruguay mediante Redpagos. |
| Santander | santander | Pagos mediante transferencia bancaria electrónica mediante Santander. |
| Banamex | banamex | Pagos mediante transferencia bancaria electrónica en México mediante Banamex. |
| Banco do Brasil | bancodobrasil | Pagos mediante transferencia bancaria electrónica en Brasil mediante Banco do Brasil. |
| PSE | pse | Pagos mediante transferencia bancaria electrónica en Colombia mediante PSE (varios bancos). |
| Efecty | efecty | Pagos en efectivo en Colombia mediante Efecty. |
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. Para archivos IPN personalizados, puedes utilizar el siguiente ejemplo como punto de inicio.
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'];
$frmprice = $_GET['frmprice'];
$frmcurrency = $_GET['frmcurrency'];
// 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 | ID de la transacción. |
| service_id | ID de servicio de tu cuenta. |
| country | Código de país de tu cliente especificado en ISO 3166 (Ej: EN, ES, FR, DE, etc.). |
| custom | Campo flexible especificado en tu formulario original. |
| key | Secret Key de tu servicio, utilizado para validar las notificaciones de pago. |
| price | Precio del producto de la transacción. |
| currency | Código de moneda de la transacción (Ej: EUR, USD, GBP, MXN, etc.). |
| frmprice | Precio original presente en el código de tu botón de pago. Puede ser usado para validación. |
| frmcurrency | Moneda original presente en el código de tu botón de pago. Puede ser usado para validación. |
| method | Método de pago utilizado por el pagador. |