Esta sección describe el Plingpago API de pasarela de pago
Plingpago La API de PaymentHub es fácil de integrar en el software de tu empresa. Nuestra API acepta solicitudes cURL, tiene URL bien formateadas y produce respuestas en JSON.
La API se puede utilizar en modo de prueba sin afectar tus datos reales. La solicitud se autentica utilizando la clave de API, que también establece si el pago es legítimo o no. Para el modo de prueba, utiliza la URL de sandbox y, en caso de modo en vivo, utiliza la URL en vivo de la sección Iniciar Pago .
Las monedas admitidas por Plingpago se muestran a continuación.
| Moneda | Símbolo de la Moneda |
|---|---|
| COP | $ |
| PEN | S/ |
| USDT | $ |
| EUR | € |
| CHF | Fr |
| GBP | £ |
| ARS | $ |
| CNY | ¥ |
| HKD | $ |
| NGN | ₦ |
| CLP | $ |
| JPY | ¥ |
| CAD | $ |
| AUD | $ |
| NZD | $ |
| ZAR | R |
| BRL | $ |
| MXN | $ |
| AED | د.إ |
| BGN | $ |
| ISK | $ |
| RUB | $ |
| PHP | $ |
| BTC | $ |
Cómo obtener la clave de API se explica en esta parte.
Para acceder a tu Plingpago cuenta de comerciante, por favor inicia sesión. En caso de que no tengas una cuenta, puedes Haga clic aquí.
Ahora ve a la Account > Settings > API Key desde el panel de comerciante.
Las claves de API se pueden encontrar allí, que son Clave pública y Clave secreta. Usa estas claves para iniciar la solicitud de la API. Cada vez puedes generar una nueva clave de API haciendo clic en Generar Clave de API botón. Recuerda no compartir estas claves con nadie.
En esta sección, se explica el procedimiento para iniciar el pago.
Para iniciar el proceso de pago, utiliza el código de muestra proporcionado y presta mucha atención a los parámetros. Los puntos finales de la API mencionados a continuación deberán utilizarse para realizar la solicitud.
Punto final en vivo: https://plingpago.com/payment/initiate
Punto final de prueba: https://plingpago.com/test/payment/initiate
Solicita al punto final con los siguientes parámetros a continuación.
| Nombre del parámetro | Tipo de parámetro | Descripción |
|---|---|---|
| public_key | string (50) | Requerido Tu clave de API pública |
| identifier | string (20) | Requerido El identificador es básicamente para identificar el pago en tu extremo |
| currency | string (4) | Requerido Código de moneda, debe estar en mayúsculas. p. ej. USD, EUR |
| amount | decimal | Requerido Monto del pago |
| details | string (100) | Requerido Detalles de tu pago o transacción |
| ipn_url | string | Requerido La URL de notificación de pago instantáneo |
| success_url | string | Requerido URL de redirección de éxito de pago |
| cancel_url | string | Requerido URL de redirección de cancelación de pago |
| site_name | string | Requerido Nombre de tu sitio web empresarial |
| site_logo | string/url | Opcional Logo de tu sitio web empresarial |
| checkout_theme | string | Opcional Tema del formulario de pago oscuro/claro. El tema predeterminado es claro |
| Cliente | ||
| customer[] | arreglo | Requerido el cliente debe ser un arreglo |
| customer.first_name | string | Requerido Nombre del cliente |
| customer.last_name | string | Requerido Apellido del cliente |
| customer.email | string | Requerido Correo electrónico válido del cliente |
| customer.mobile | string | Requerido Número de móvil válido del cliente | Información de envío |
| shipping_info[] | arreglo | Opcional shipping_info debe ser un arreglo |
| shipping_info.address_one | string | Opcional Customer's address one |
| shipping_info.address_two | string | Opcional Customer's address two |
| shipping_info.area | string | Opcional Área de envío del cliente |
| shipping_info.city | string | Opcional Ciudad de envío del cliente |
| shipping_info.sub_city | string | Opcional Subciudad de envío del cliente |
| shipping_info.state | string | Opcional Estado de envío |
| shipping_info.postcode | string | Opcional Código postal de envío |
| shipping_info.country | string | Opcional País de envío |
| shipping_info.others | string | Opcional Otra información | Información de facturación |
| billing_info[] | arreglo | Opcional billing_info debe ser un arreglo |
| billing_info.address_one | string | Opcional Customer's address one |
| billing_info.address_two | string | Opcional Customer's address two |
| billing_info.area | string | Opcional Área de facturación del cliente |
| billing_info.city | string | Opcional Ciudad de facturación del cliente |
| billing_info.sub_city | string | Opcional Subciudad de facturación del cliente |
| billing_info.state | string | Opcional Estado de facturación |
| billing_info.postcode | string | Opcional Código postal de facturación |
| billing_info.country | string | Opcional País de facturación |
| billing_info.others | string | Opcional Otra información |
<?php
$parameters = [
'identifier' => 'DFU80XZIKS',
'currency' => 'USD',
'amount' => 11.00,
'gateway_methods' => [
// Please write the name of the gateway method you want to use
],
'details' => 'Purchase T-shirt',
'ipn_url' => 'http://example.com/ipn_url.php',
'cancel_url' => 'http://example.com/cancel_url.php',
'success_url' => 'http://example.com/success_url.php',
'public_key' => 'your_public_key',
'site_name' => 'your_site_name',
'site_logo' => 'http://yoursite.com/logo.png',
'checkout_theme' => 'light',
'customer'=>[
'first_name'=>'John',
'last_name'=>'Doe',
'email'=>'[email protected]',
'mobile'=>'12345789',
],
'shipping_info'=>[
'address_one'=>'',
'address_two'=>'',
'area'=>'',
'city'=>'',
'sub_city'=>'',
'state'=>'',
'postcode'=>'',
'country'=>'',
'others'=>'',
],
'billing_info'=>[
'address_one'=>'',
'address_two'=>'',
'area'=>'',
'city'=>'',
'sub_city'=>'',
'state'=>'',
'postcode'=>'',
'country'=>'',
'others'=>'',
]
];
$parameters = http_build_query($parameters);
//live end point
$url = 'https://plingpago.com/payment/initiate';
//test end point
$url = 'https://plingpago.com/test/payment/initiate';
$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
?>//Error Response.
{
"status": "error",
"message": [
"Invalid api key"
]
}
//Success Response.
{
"status": "success",
"message": [
"Payment initiated"
],
"redirect_url": "https://example.com/payment/checkout?payment_trx=eyJpdiI6IkFyNllSNU1lOFdkYTlPTW52cytPNGc9PSIsInZhbHVlIjoiWWowRTRjdzZ1S1BBRm4ydS81OWR1WjdXeFIxcjE1WkZRVE9BcmZYeXpzND0iLCJtYWMiOiJjNDdhODUzYzY2NmZlZGJjZTI5ODQyMmRkYzdjYjRmM2NiNjg4M2RiMWZjN2EyMzFkODI4OWMwYjk3ZWYwNGQwIiwidGFnIjoiIn0%3D"
}
Esta sección describe el proceso para obtener tu notificación de pago instantáneo.
Para iniciar el pago, sigue el código de ejemplo y ten cuidado con los parámetros. Deberás realizar una solicitud con los siguientes puntos finales de API.
Punto final: URL de IPN de tu aplicación empresarial
Método de solicitud: POST
Obtendrás los siguientes parámetros a continuación.
| Nombre del parámetro | Descripción |
|---|---|
| status | Estado de éxito del pago. |
| identifier | El identificador es básicamente para identificar el pago en tu extremo. |
| signature | Una firma hash para verificar tu pago en tu extremo. |
| data | Los datos contienen información básica con cargos, monto, moneda, ID de transacción de pago, etc. |
<?php
//Receive the response parameter
$status = $_POST['status'];
$signature = $_POST['signature'];
$identifier = $_POST['identifier'];
$data = $_POST['data'];
// Generate your signature
$customKey = $data['amount'].$identifier;
$secret = 'YOUR_SECRET_KEY';
$mySignature = strtoupper(hash_hmac('sha256', $customKey , $secret));
$myIdentifier = 'YOUR_GIVEN_IDENTIFIER';
if($status == "success" && $signature == $mySignature && $identifier == $myIdentifier){
//your operation logic
}
?>Lorem ipsum dolor sit amet consectetur adipisicing elit consectetur adipisicing elit sit amet con m ipsum