TindaPay - Developer - Api Documentation

Introduction

Cette section décrit TindaPay l'API de passerelle de paiement.

TindaPay L'API est facile à implémenter dans votre logiciel d'entreprise. Notre API utilise des URL bien formatées, accepte les requêtes cURL et renvoie des réponses JSON.

Vous pouvez utiliser l'API en mode test, ce qui n'affecte pas vos données réelles. La clé API est utilisée pour authentifier la requête et déterminer si le paiement est valide. Pour le mode test, utilisez simplement l'URL sandbox et pour le mode réel, utilisez l'URL live de la section Initier Paiement .

Obtenir la Clé Api

Cette section décrit comment obtenir votre clé api.

Connectez-vous à votre TindaPay compte marchand. If you don't have any ? Cliquez ici

L'étape suivante est de trouver le menu Clé Api dans la barre latérale de votre tableau de bord. Cliquez sur le menu.

Les clés api peuvent y être trouvées, qui sont Clé publique et Clé secrète. Utilisez ces clés pour initier la requête API. À chaque fois, vous pouvez générer une nouvelle clé API en cliquant sur Générer Clé Api le bouton. Rappelez-vous de ne partager ces clés avec personne.

Initier Paiement

Cette section décrit le processus d'initiation du paiement.

Pour initier le paiement, suivez le code exemple et faites attention aux paramètres. Vous devrez faire une requête avec les points de terminaison API suivants.

Point de terminaison Live : https://pay.tinda.pro/payment/initiate

Point de terminaison Test : https://pay.tinda.pro/sandbox/payment/initiate

Mail Mode Test : test_mode@mail.com

Code Vérification Mode Test : 222666

Méthode de requête : POST

Requête au point de terminaison avec les paramètres ci-dessous.

Nom Param	Type Param	Description
public_key	string (50)	Requis Votre clé API Publique
identifier	string (20)	Requis L'identifiant sert essentiellement à identifier le paiement de votre côté
currency	string (4)	Requis Code de devise, doit être en majuscules. ex: USD,EUR
amount	decimal	Requis Montant du paiement.
details	string (100)	Requis Détails de votre paiement ou transaction.
ipn_url	string	Requis L'url de notification de paiement instantané.
success_url	string	Requis Url de redirection succès paiement.
cancel_url	string	Requis Url de redirection annulation paiement.
site_logo	string/url	Requis Logo de votre site d'entreprise.
checkout_theme	string	Optionnel Thème du formulaire de paiement sombre/clair. Le thème par défaut est clair
customer_name	string (30)	Requis Nom du client.
customer_email	string (30)	Requis Email valide du client.

Exemple de code 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://pay.tinda.pro/assets/images/logoIcon/logo.png',
        'checkout_theme' => 'dark',
        'customer_name' => 'John Doe',
        'customer_email' => 'john@mail.com',

    ];

    //live end point
    $url = "https://pay.tinda.pro/payment/initiate";

    //test end point
    $url = "https://pay.tinda.pro/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.
?>

Exemples de réponses

//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"
}

Valider le paiement et IPN

Cette section décrit le processus pour obtenir votre notification de paiement instantané.

Pour initier le paiement, suivez le code exemple et faites attention aux paramètres. Vous devrez faire une requête avec les points de terminaison API suivants.

Point de terminaison : L'url ipn de votre application d'entreprise.

Méthode de requête : POST

Vous obtiendrez les paramètres suivants ci-dessous.

Nom Param	Description
status	Statut de succès du paiement.
identifier	L'identifiant sert essentiellement à identifier le paiement de votre côté.
signature	Une signature hash pour vérifier votre paiement de votre côté.
data	Data contient des informations de base avec frais, montant, devise, id de transaction de paiement etc.

Exemple de code 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
    }
?>