Developer - Api Documentation

Introducción

Esta sección describe el MoneyD API de la pasarela de pago.


MoneyD La API es fácil de implementar en el software de su negocio. Nuestra API tiene URLs bien formateadas, acepta solicitudes cURL y devuelve respuestas JSON.

Puede usar la API en modo de prueba, lo que no afecta sus datos en vivo. La clave de API se utiliza para autenticar la solicitud y determina si la solicitud es un pago válido o no. Para el modo de prueba, simplemente use la URL de sandbox y en caso de modo en vivo, use la URL en vivo de la sección Iniciar pago .

Monedas admitidas

En esta sección se describen las monedas admitidas por MoneyD


MoneyD allows to make transaction with below currencies. Any new currency may update in future.

Currency Name Currency Symbol Currency Code
United States Dollar $ USD
Peso Colombiano COL$ COP
Peso Mexicano MX$ MXM
Bitcoin BTC
Tether T ETH
USDT USDT

Obtener la clave de API

Esta sección describe cómo puede obtener su clave de API.


Inicie sesión en su MoneyD cuenta de comerciante. If you don't have any ? Haga clic aquí

El siguiente paso es encontrar el Clave de API menú en la barra lateral de su panel de control. Haga clic en el menú.

Las claves de API se pueden encontrar ahí, que son Clave pública y clave secreta. Utilice estas claves para iniciar la solicitud de API. Cada vez puede generar una nueva clave de API haciendo clic en Generar clave de API botón. Recuerde no compartir estas claves con nadie.

Iniciar pago

Esta sección describe el proceso de iniciación del pago.


Para iniciar el pago, siga el código de ejemplo y tenga cuidado con los parámetros. Necesitará hacer la solicitud con los siguientes puntos finales de la API.

Punto final en vivo: https://moneyd.app/payment/initiate

Punto final de prueba: https://moneyd.app/sandbox/payment/initiate

Correo de modo de prueba: test_mode@mail.com

Código de verificación de modo de prueba: 222666

Método de solicitud: POST

Solicitud 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 Su clave de API pública
identifier string (20) Requerido El identificador es básicamente para identificar el pago en su 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 su pago o transacción.
ipn_url string Requerido La URL de la notificación de pago instantáneo.
success_url string Requerido URL de redireccionamiento de éxito de pago.
cancel_url string Requerido URL de redireccionamiento de cancelación de pago.
site_logo string/url Requerido El logo de su sitio comercial.
checkout_theme string Opcional Tema del formulario de pago oscuro/claro. El tema predeterminado es claro
customer_name string (30) Requerido Nombre del cliente.
customer_email string (30) Requerido Correo electrónico válido del cliente.
Código de ejemplo PHP
<?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' => 'https://moneyd.app/assets/images/logoIcon/logo.png',
        'checkout_theme' => 'dark',
        'customer_name' => 'John Doe',
        'customer_email' => 'john@mail.com',

    ];

    //live end point
    $url = "https://moneyd.app/payment/initiate";

    //test end point
    $url = "https://moneyd.app/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 IPN

Esta sección describe el proceso para obtener su notificación de pago instantáneo.


Para iniciar el pago, siga el código de ejemplo y tenga cuidado con los parámetros. Necesitará hacer la solicitud con los siguientes puntos finales de la API.

Punto final: La URL ipn de su aplicación comercial.

Método de solicitud: POST

Recibirá 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 su extremo.
signature Una firma hash para verificar su pago en su extremo.
data Los datos contienen alguna información básica con cargos, monto, moneda, ID de transacción de pago, etc.
Código de ejemplo PHP
<?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. aprender más

Permitir