Introducción

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 .

Obtener la clave API

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.

Iniciar pago

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.
Código PHP de ejemplo
<?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.
?>
Respuestas de ejemplo
//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"
}

Validar el pago y el IPN

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.
Código PHP de ejemplo
<?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
    }
?>

We may use cookies or any other tracking technologies when you visit our website, including any other media form, mobile website, or mobile application related or connected to help customize the Site and improve your experience. más información

Permitir