Introducción
Esta sección describe el troeke API PAGO DE PAGO.
troeke 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 troeke
troeke 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 |
|---|---|---|
| Dolar | USD | USD |
| TROEKE | TRK | TRK |
| TROEKE EURO | TRK-EUR | TRK-EUR |
| TROEKE DOLAR | TRK-USA | TRK-USA |
Obtener la clave de la API
Esta sección describe cómo puede obtener su clave API.
Inicia sesión en tu troeke 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://troeke.com/payment/initiate
Punto final de prueba: https://troeke.com/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. |
<?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://troeke.com/assets/images/logoIcon/logo.png',
'checkout_theme' => 'dark',
'customer_name' => 'John Doe',
'customer_email' => 'john@mail.com',
];
//live end point
$url = "https://troeke.com/payment/initiate";
//test end point
$url = "https://troeke.com/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"
}
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. |
<?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
}
?>