Esta sección describe la Rapicash API de la pasarela de pagos.
Rapicash La API es fácil de implementar en el software de su negocio. Nuestra API utiliza URL con formato adecuado, acepta solicitudes cURL y devuelve respuestas JSON.
Puede utilizar la API en modo de prueba, que no afecta sus datos reales. La clave API se utiliza para autenticar la solicitud y determinar si el pago es válido. Para el modo de prueba, use la URL de sandbox; para el modo real, use la URL real de la sección correspondiente. Iniciar pago .
Esta sección explica cómo obtener su clave API.
Inicie sesión en su Rapicash cuenta de comerciante. If you don't have any ? Haga clic aquí
El siguiente paso es encontrar el Clave API menú Clave API en la barra lateral de su panel. Haga clic en el menú.
Allí encontrará las claves API, que son Clave pública y clave secreta. Utilice estas claves para iniciar la solicitud API. Puede generar una nueva clave API en cualquier momento haciendo clic en Generar clave API el botón. Recuerde no compartir estas claves con nadie.
Esta sección describe el proceso para iniciar el pago.
Para iniciar el pago, siga el código de ejemplo y tenga cuidado con los parámetros. Deberá realizar la solicitud a los siguientes endpoints de la API.
Endpoint real: http://rapicash.win/payment/initiate
Endpoint de prueba: http://rapicash.win/sandbox/payment/initiate
Correo del modo de prueba: test_mode@mail.com
Código de verificación del modo de prueba: 222666
Método de solicitud: POST
Realice la solicitud al endpoint con los siguientes parámetros.
| Nombre del parámetro | Tipo de parámetro | Descripción |
|---|---|---|
| public_key | string (50) | Obligatorio Su clave API pública |
| identifier | string (20) | Obligatorio El identificador sirve básicamente para identificar el pago en su sistema |
| currency | string (4) | Obligatorio Código de moneda, debe estar en mayúsculas. Ej.: USD, EUR |
| amount | decimal | Obligatorio Monto del pago. |
| details | string (100) | Obligatorio Detalles de su pago o transacción. |
| ipn_url | string | Obligatorio URL de la notificación instantánea de pago. |
| success_url | string | Obligatorio URL de redirección después de un pago exitoso. |
| cancel_url | string | Obligatorio URL de redirección después de cancelar el pago. |
| site_logo | string/url | Obligatorio Logotipo de su sitio comercial. |
| checkout_theme | string | Opcional Tema oscuro/claro del formulario de pago. El tema predeterminado es claro |
| customer_name | string (30) | Obligatorio Nombre del cliente. |
| customer_email | string (30) | Obligatorio Correo electrónico válido del cliente. |
<?php
$parameters = [
'identifier' => 'DFU80XZIKS',
'currency' => 'USD',
'amount' => 100.00,
'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_logo' => 'http://rapicash.win/assets/images/logoIcon/logo.png',
'checkout_theme' => 'dark',
'customer_name' => 'John Doe',
'customer_email' => 'john@mail.com',
];
//live end point
$url = "http://rapicash.win/payment/initiate";
//test end point
$url = "http://rapicash.win/sandbox/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);
//$result contains the response back.
?>
//Error Response.
{
"error": "true",
"message": "Invalid api key"
}
//Success Response.
{
"success": "ok",
"message": "Payment Initiated. Redirect to url.",
"url":"http://example.com/initiate/payment/checkout?payment_id=eJSAASDxdrt4DASDASVNASJA7893232432cvmdsamnvASF"
}
Esta sección describe el proceso para obtener su notificación instantánea de pago.
Para iniciar el pago, siga el código de ejemplo y tenga cuidado con los parámetros. Deberá realizar la solicitud a los siguientes endpoints de la API.
Endpoint: URL del IPN de su aplicación comercial.
Método de solicitud: POST
Recibirá los siguientes parámetros.
| Nombre del parámetro | Descripción |
|---|---|
| status | Estado de pago exitoso. |
| identifier | El identificador sirve básicamente para identificar el pago en su sistema. |
| signature | Una firma hash para verificar el pago en su sistema. |
| data | Los datos contienen información básica sobre 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
}
?>