Vista General
Nuestra implementación API ofrece un alto nivel de personalización, permitiéndote implementar una solución de pagos white label directamente en tu plataforma de una forma rápida y fácil.
Esta implementación está basada en llamadas POST/GET a servicios web, los cuales entregarán una respuesta en XML o texto plano, según prefieras. La respuesta contendrá una URL a la cual podrás redirigir a tus clientes para comenzar el proceso de pago.
Cómo usar la implementación API
Para crear un nuevo pago se debe realizar un llamado a la siguiente URL:
https://www.paygol.com/pay
Descripción de parámetros
Los siguientes parámetros POST/GET son requeridos:
Códigos de los métodos de pago disponibles:
| Nombre |
Cobertura |
Código |
Descripción |
Ejemplo:
https://www.paygol.com/pay?pg_serviceid=123&pg_price=5.00&pg_currency=EUR&pg_custom=player123&pg_return_url=http://www.mysite.com/return.php
&pg_cancel_url=http://www.mysite.com/cancel.php&pg_mode=api&pg_country=ES&pg_language=es&pg_method=creditcard&pg_format=txt
&pg_ip=123.123.123.123&[email protected]&pg_first_name=John&pg_last_name=Smith&pg_personalid=12345678-6
Respuesta (texto plano)
OK|service|payment_method|payment_methods|id|price|currency|price_consumer|currency_consumer|locale|payment_method_url|custom|return_url|cancel_url
Ejemplo:
OK|123456|webpay|webpay,servipag,multicaja|XXXX-YYYY-ZZZZ-1234|10.00|EUR|10.00|EUR|es-CL|https://www.paygol.com/api/pay-direct/XXXX-YYYY-ZZZZ-1234
|player123|http://www.mysite.com/return.php|http://www.mysite.com/cancel.php
Respuesta en caso de error:
NOK|error_message
Ejemplo:
NOK|Wrong country
Respuesta (XML)
<transaction>
<response>OK</response>
<service>123456</service>
<payment_method>webpay</payment_method>
<payment_methods>webpay,servipag,multicaja</payment_methods>
<id>XXXX-YYYY-ZZZZ-1234</id>
<price>10.00</price>
<currency>EUR</currency>
<price_consumer>10.00</price_consumer>
<currency_consumer>EUR</currency_consumer>
<locale>es-CL</locale>
<payment_method_url>https://www.paygol.com/api/pay-direct/XXXX-YYYY-ZZZZ-1234</payment_method_url>
<custom>player123</custom>
<return_url>http://www.mysite.com/return.php</return_url>
<cancel_url>http://www.mysite.com/cancel.php</cancel_url>
</transaction>
Respuesta en caso de error (ejemplo):
<transaction>
<response>NOK</response>
<error_message>Wrong country</error_message>
</transaction>
Los parámetros de respuesta son los mismos sin importar el formato de la misma.
Verificar el estado de un pago
Para verificar el estado de un pago se debe realizar una petición a la siguiente URL:
https://www.paygol.com/api/check-payment
Los siguientes parámetros POST/GET son requeridos:
Ejemplo:
https://www.paygol.com/api/check-payment?service=123&id=XXXX-YYYY-ZZZZ-1234&format=txt
Respuesta (texto plano)
ID de transacción encontrado, independiente de su estado actual:
OK|status
Ejemplo:
OK|completed
Respuesta en caso de error:
NOK|error_message
Ejemplo:
NOK|Transaction ID not found
Respuesta (XML)
ID de transacción encontrado, independiente de su estado actual (ejemplo):
<transaction>
<response>OK</response>
<status>completed</status>
</transaction>
Respuesta en caso de error (ejemplo):
<transaction>
<response>NOK</response>
<error_message>Transaction ID not found</error_message>
</transaction>
Los parámetros de respuesta son los mismos sin importar el formato de la misma.
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'];
// 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
