Banner App

Puntos Finales API y Autenticación

All requests to the Gamezoid - Juegos de azar API are sent via the HTTP POST method to one of our API endpoint URLs.

Método de Solicitud HTTP : POST
Punto Final API : https://wallet.geekskullstudios.com/payment/process
JSON Content-Type : application/json

Todas las llamadas a la Gamezoid - Juegos de azar API require merchant authentication and merchant access key. Sign up for a account to quickly get started.
El pago en modo sandbox también se puede iniciar mientras el comerciante establezca el modo de servicio como prueba en el panel del comerciante. Estará en vivo mientras el modo esté configurado como modo activo.

Clave de Acceso API

Regístrate como comerciante en nuestro sistema. En tu panel de comerciante encontrarás la opción para la clave de acceso API.

Ejemplo de clave de acceso : 51a4bd18-5bc1-4eaa-97b0-c09323398883

Iniciar Transacción de Pago

El siguiente código de ejemplo te permite iniciar un pago, dependiendo de cómo lo estructures. Los detalles de los parámetros también están a continuación.

Nombre del Parámetro	Tipo de Parámetro	Descripción
personalizado	cadena	Identificación de su extremo Requerido
cantidad	decimal	La cantidad que deseas transaccionar Requerido
detalles	cadena	Detalles de Compra String Max 255
web_hook	cadena	URL de notificación de pago instantáneo Requerido
cancel_url	cadena	URL de retorno de cancelación de pago Requerido
success_url	cadena	URL de retorno de éxito de pago Requerido
customer_email	cadena	Dirección de correo electrónico del cliente Requerido
clave_de_acceso	cadena	Enviar access_key como token portador con encabezado Requerido

                                
    
            <?php
                $parameters = [
                    'custom' => 'DFU80XZIKS',
                    'currency_code' => 'USD',
                    'amount' => 280.00,
                    'details' => 'Digital Product',
                    'web_hook' => 'http://yoursite.com/web_hook.php',
                    'cancel_url' => 'http://yoursite.com/cancel_url.php',
                    'success_url' => 'http://yoursite.com/success_url.php',
                    'customer_email' => 'customer@mail.com',
                ];
                
                $url = 'http://yourwallet.com/payment/process';
                
                $headers = [
                    "Accept: application/json",
                    "Authorization: Bearer access_key",
                ];
                
                $ch = curl_init();
                curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
                curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
                curl_setopt($ch, CURLOPT_URL, $url);
                curl_setopt($ch, CURLOPT_POSTFIELDS,  http_build_query($parameters));
                curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                $response = curl_exec($ch);
                curl_close($ch);
            ?>

Ejemplo de respuesta después de iniciar el pago

                                
        
        
            //Success Response.
            {
                "code": 200,
                "status": "ok",
                "payment_id": "AIYmQIOAz0GlmsjfhgiOeu304",
                "message": "Your payment has been processed. Please follow the URL to complete the payment.",
                "url":"https://wallet.geekskullstudios.com/process-checkout?payment_id=AIYmQIOAz0GlmsjfhgiOeu304"
            }

            //Error Response.
            {
                "code": 401,
                "status": "error",
                "message": "Invalid API credentials."
            }

Respuesta después del pago exitoso

                                
        
        
            //Success Response.
            {
                "code": 200,
                "status": "ok",
                "payment_id": "AIYmQIOAz0GlmsjfhgiOeu304",
                "transaction": "AIYmQIOAz0G",
                "amount": 100.00,
                "charge": 5.00,
                "currency": "USD",
                "custom": "BVSUZ545XCS",
                "date"  : "22-05-2022"
            }

Verificar Pago

Puede verificar el pago, ya sea válido o no. Después de una transacción de pago exitosa, tendrá la respuesta donde encontrará el ID de pago. Con este ID de pago y su clave de acceso, debe hacer una solicitud a nuestro servidor para verificar el pago. El código de ejemplo se muestra a continuación.

Payment verify end point : https://wallet.geekskullstudios.com/payment/check-validity

                                
    
            <?php
                $parameters = [
                    'payment_id' => 'AIYmQIOAz0GlmsjfhgiOeu304',
                ]
                
                $url = 'https://wallet.geekskullstudios.com/payment/check-validity';
                
                $headers = [
                    "Accept: application/json",
                    "Authorization: Bearer access_key",
                ];
                
                $ch = curl_init();
                curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
                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);
                $response = curl_exec($ch);
                curl_close($ch);
            ?>

Respuesta de Validez

                                
        
        
            //Success Response.
            {
                "code": 200,
                "status": "ok",
                "message": "Transaction is valid",
                
            }

            //Error Response.
            {
                "code": 401,
                "status": "error",
                "message": "Invalid API credentials."
            }

            //or
            {
                "code": 404,
                "status": "error",
                "message": "Transaction not found"
            }

Monedas Soportadas

Las siguientes monedas son actualmente compatibles en nuestro sistema. Puede actualizarse más adelante.

Nombre de Moneda	Símbolo de Moneda	Código de Moneda
United State Dollar	$	USD
Bitcoin	₿	BTC
Pesos Colombianos	COP	COP
Bolívares Soberanos	VES	VES

Documentación API