Developer Api Documentation

Introducción

Esta sección describe el STOCKEN API PAGO DE PAGO.


STOCKEN API es fácil de implementar en su software de negocios. Nuestra API es URL bien formateada, acepta solicitudes de rizo, devuelve las respuestas JSON.

You can use the API in test mode, which does not affect your live data. The API key is use to authenticate the request and determines the request is valid payment or not. For test mode just use the sandbox URL and In case of live mode use the live URL from section Iniciar el pago .

Monedas apoyadas

Esta sección describe las monedas admitidas por STOCKEN


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

Nombre de la moneda Símbolo de moneda Código de moneda
THETER USDT USDT USDT
DOLAR $ USD
HARBBLUE HB HARBBLUE
Agrosky AS AGROSKY
Reflejos RFL REFLEJOS
STOCKEN TKS STOCKEN
QUIINN TOKEN QINN QINN

Obtener la clave de la API

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


Inicia sesión en tu STOCKEN cuenta comercial. If you don't have any ? Haga clic aquí

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

Las teclas API se pueden encontrar allí, que es Llave pública y clave secreta. Use estas claves para iniciar la solicitud API. Cada vez que puedes generar una nueva llave API haciendo clic en Generar la tecla API botón. Recuerda que no comparta estas claves con nadie.

Iniciar el 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 perámetes. Tendrá que solicitar la solicitud con estos siguientes puntos finales de API.

Punto final en vivo: https://stockens.exchange/payment/initiate

Punto final de prueba: https://stockens.exchange/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

Solicitud al punto final con los siguientes parámetros a continuación.

Nombre de param Tipo de param Descripción
public_key string (50) Requerido Su clave de API PUBLIC
identifier string (20) Requerido El identificador es básicamente para identificar el pago a su fin.
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 El éxito del éxito redirige la URL.
cancel_url string Requerido Pago Cancelar Redirect URL.
site_logo string/url Requerido El logotipo de su sitio de negocios.
checkout_theme string Opcional Checkout form theme dark/light. Default theme is light
customer_name string (30) Requerido Nombre del cliente.
customer_email string (30) Requerido Customer válido por correo electrónico.
Ejemplo de código 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://stockens.exchange/assets/images/logoIcon/logo.png',
    'checkout_theme' => 'dark',
    'customer_name' => 'John Doe',
    'customer_email' => 'john@mail.com',

];

//live end point
$url = 'https://stockens.exchange/payment/initiate';

//test end point
$url = 'https://stockens.exchange/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 la 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 perámetes. Tendrá que solicitar la solicitud con estos siguientes puntos finales de API.

Punto final: Su aplicación de empresa IPN URL.

Método de solicitud: POST

Obtendrá los siguientes parámetros a continuación.

Nombre de param Descripción
status Estado del éxito del pago.
identifier El identificador es básicamente para identificar el pago a su fin.
signature Una firma de hash para verificar su pago al final.
data Los datos contienen información básica con cargos, cantidad, moneda, identificación de transacción de pago, etc.
Ejemplo de código 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
    }
?>

Podemos utilizar cookies o cualquier otra tecnología de seguimiento cuando visite nuestro sitio web, incluido cualquier otro formulario de medios, sitio web móvil o aplicación móvil relacionada o conectada para ayudar a personalizar el Sitio y mejorar su experiencia..

Permitir