DOC MYPAYGA

Documentation développeurs

Bienvenue sur MYPAYGA ! Familiarisez-vous avec nos API et explorez leurs fonctionnalités.

Paiements

Collectez des paiements par Mobile Money ou Cartes Bancaires

Transferts

Effectuer des transferts vers des numéros Mobile Money

Vérifications

Consulter le statut des transactions

Plugins

Plugins pour les sites fait à partir d'un CMS

Données de test

Données à utiliser lors des tests d'intégration.

Démarrer

MyPayGa utilise des clés API pour permettre l'accès à l'API.MyPayGa s'attend à ce que la clé API soit incluse dans toutes les requêtes API transmises au serveur.
Afin d'utiliser nos API, il faut préalablement créer un compte.Si vous n'en avez pas encore, merci de cliquer ici pour s'inscrire
Une fois le compte crée, connectez-vous et suivez les étapes ci-dessous :

  • Accédez à l'onglet API. 
  • Sélectionnez l'environnement que vous souhaitez utiliser. 

Préréquis

Afin d'accepter les paiements, vous devriez avant tout déclarer des urls de notification. Elles seront utilisées pour vous transmettre le statut final du paiement ou rediriger vos clients.
A défaut de les renseigner depuis votre espace client, vous pouvez déclarer ces url directement dans vos requêtes.

Cette url permet, lors d'une intégration standard, de rediriger vos clients vers une page specifique en cas de succès.
Cette url permet, lors d'une intégration standard, de rediriger vos clients vers une page specifique en cas d'échec.
Cette url permet, lors d'une intégration dirrecte de vous transmettre le statut final du paiement.

Intégration standard (HTML)

Cette option de paiement est entièrement réalisée en HTML. Vous créez un formulaire HTML standard contenant les informations du paiement. Lorsque le client soumet le formulaire, il sera redirigé vers notre page de paiement où il pourra effectuer le paiement.

A la fin du paiement, le client sera redirigé vers votre page de succès (ou échec) avec en paramètre la référence de la commande.

                                        
                                               <form method="POST" action="https://checkout.mypayga.com/v1/hosted">
                                                    <input type="text" name="amount" value="100">
                                                    <input type="text" name="unique_id" value="123">
                                                    <input type="text" name="apikey" value="stest_1234">
                                                    <input type="text" name="description">
                                                    <input type="text" name="firstname" value="John">
                                                    <input type="text" name="lastname" value="Kassa">
                                                    <input type="text" name="phone">
                                                    <input type="text" name="email" value="email@gmail.com">
                                                    <input type="text" name="currency">
                                                    <input type="text" name="success_url">
                                                    <input type="text" name="fail_url">
                                                    <input type="text" name="country" value="GA">
                                                    <input type="text" name="network" value="AM">
                                                    <input type="text" name="type" value="mobile_money">
                                                    <input type="text" name="callback_url" value="https://monsite.com/callback">
                                                    <button type="submit" id="submitpayment" value="Submit"></button >
                                                </form>

Intégration directe

Vous souhaitez plus de contrôle ou une solution personnalisée adaptée à votre application, l'intégration directe est faites pour vous. Nous vous fournissons les API pour facturer les paiements, vous personnalisez et contrôlez l'expérience client comme vous le souhaitez.

Exemples de requêtes

                                         
                                        $curl = curl_init();
                                        curl_setopt_array($curl, array(
                                          CURLOPT_URL => 'https://api.mypayga.com/v1/payment',
                                          CURLOPT_RETURNTRANSFER => true,
                                          CURLOPT_ENCODING => '',
                                          CURLOPT_MAXREDIRS => 10,
                                          CURLOPT_TIMEOUT => 0,
                                          CURLOPT_FOLLOWLOCATION => true,
                                          CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
                                          CURLOPT_CUSTOMREQUEST => 'POST',
                                          CURLOPT_POSTFIELDS =>' {
                                            "urls": {
                                                "success_url": "https://monsite.com/success-url",
                                                "callback_url": "https://monsite.com/callback-url",
                                                "fail_url": "https://monsite.com/fail-url"
                                                },
                                            "apikey": "stest_abcd1234",
                                            "client_phone": "074121212",
                                            "amount": "100",
                                            "country": "GA",
                                            "network": "AM",
                                            "type":"mobile_money",
                                            "unique_id":"1234",
                                            "firstname":"Client Prenom",
                                            "lastname":"Client Nom",
                                            "email":"email@gmail.com"
                                        }',
                                          CURLOPT_HTTPHEADER => array(
                                            'Content-Type: application/json'
                                          ),
                                        ));

                                        $response = curl_exec($curl);
                                        curl_close($curl);
                                        echo $response;
                                        
                                    
                                         
                                        var myHeaders = new Headers();
                                            myHeaders.append("Content-Type", "application/json");

                                            var raw = JSON.stringify({
                                              "urls": {
                                                "success_url": "https://monsite.com/success-url",
                                                "callback_url": "https://monsite.com/callback-url",
                                                "fail_url": "https://monsite.com/fail-url"
                                              },
                                              "apikey": "stest_abcd1234",
                                              "client_phone": "07xxxx",
                                              "amount": "100",
                                              "country": "GA",
                                              "network": "AM",
                                              "type": "mobile_money",
                                              "unique_id": "12z34",
                                              "firstname": "Prenom",
                                              "lastname": "Nom",
                                              "email": "email@gmail.com"
                                            });

                                            var requestOptions = {
                                              method: 'POST',
                                              headers: myHeaders,
                                              body: raw,
                                              redirect: 'follow'
                                            };

                                            fetch("https://api.mypayga.com/v1/payment", requestOptions)
                                              .then(response => response.text())
                                              .then(result => console.log(result))
                                              .catch(error => console.log('error', error));
                                        
                                        
                                         
                                        import requests
                                        import json

                                        url = "https://api.mypayga.com/v1/payment"

                                        payload = json.dumps({
                                          "urls": {
                                            "success_url": "https://monsite.com/success-url",
                                            "callback_url": "https://monsite.com/callback-url",
                                            "fail_url": "https://monsite.com/fail-url"
                                          },
                                          "apikey": "stest_i1234abcd",
                                          "client_phone": "07xxxx",
                                          "amount": "100",
                                          "country": "GA",
                                          "network": "AM",
                                          "type": "mobile_money",
                                          "unique_id": "12z34",
                                          "firstname": "Prenom",
                                          "lastname": "Nom",
                                          "email": "email@gmail.com"
                                        })
                                        headers = {
                                          'Content-Type': 'application/json'
                                        }

                                        response = requests.request("POST", url, headers=headers, data=payload)
                                        print(response.text)

Réponse

                                         
                                            {
                                                "message": "Request Sent.Please Wait.",
                                                "payment_token": "2de1c9f9-877a-42b4-a30c-5916a5bf0e85",
                                                "description": "Paiment : 112728406-12z34",
                                                "statusRequest": "200",
                                                "request_status": "200",
                                                "transaction": {
                                                    "amount": 100,
                                                    "country": "GA",
                                                    "currency": "CFA",
                                                    "id": "12z34"
                                                }
                                            }

Données de tests

Lors de vos tests d'intégration, vous pouvez ajouter des numéros de tests depuis votre espace.

Moyens de paiement

Moyens de paiment pris en charge

Moyen de paiement Valeur API
Mobile Money mobile_money
Carte Bancaire card

Réponse callback

L'URL de callback vous permet de recevoir la réponse finale de votre paiement.
Exemple de données envoyées sur votre url callback.

Pour des raisons de sécurité, le callback est envoyé avec une signature.

                                        
                                        $secret_key=xxxxxxxx (fournie par nos équipes)
                                        $callback_infos=$order_status.$unique_id.$amount.$payment_token.$payment_method.$message.$client_phone;
                                        $hash=hash_hmac('sha512', $callback_infos, $secret_key); 

                                        
                                    
                                         
                                            {   "hash"=>dWjOShL3Ua0Ien0d6Y2qEytmQmT8KyQT,
                                                "order_status": "200",
                                                "unique_id": "9505",
                                                "amount": "29928",
                                                "payment_token": "67ee3da6badad-67ee3da6badae",
                                                "payment_method": "Airtel Money",
                                                "message": "Payment success",
                                                "status_request": 200,
                                                "currency":"FCFA",
                                                "country":"GA"
                                            }

Vérifications

Cette API vous permet de récuperer certaines informations telles que le réseau mobile lié à un numéro de téléphone

Exemples de requêtes

                                         
                                        $curl = curl_init();
                                        $url = "https://api.mypayga.com/network?apikey=sprod_123&tel_number=07712345&country=GA&type=mobile_money";

                                        curl_setopt_array($curl, array(
                                          CURLOPT_URL => $url,
                                          CURLOPT_RETURNTRANSFER => true,
                                          CURLOPT_ENCODING => '',
                                          CURLOPT_MAXREDIRS => 10,
                                          CURLOPT_TIMEOUT => 0,
                                          CURLOPT_FOLLOWLOCATION => true,
                                          CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
                                          CURLOPT_CUSTOMREQUEST => 'GET',
                                        ));

                                        $response = curl_exec($curl);
                                        curl_close($curl);
                                        echo $response;
                                        
                                    
                                         
                                        var requestOptions = {
                                          method: 'GET',
                                          redirect: 'follow'
                                        };
                                        url = "https://api.mypayga.com/network?apikey=sprod_123&tel_number=07712345&country=GA&type=mobile_money"

                                        fetch("url, requestOptions)
                                          .then(response => response.text())
                                          .then(result => console.log(result))
                                          .catch(error => console.log('error', error));
                                        
                                        
                                         
                                        import requests

                                        url = "https://api.mypayga.com/network?apikey=sprod_123&tel_number=07712345&country=GA&type=mobile_money"

                                        payload={}
                                        headers = {}

                                        response = requests.request("GET", url, headers=headers, data=payload)

                                        print(response.text)

Réponse

                                         
                                            {
                                                "message": "Network Found",
                                                "network": "Airtel Gabon",
                                                "mobile_money_logo": "",
                                                "mobile_money_code": "AM",
                                                "country": "GA",
                                                "mobile_money_svce": "Airtel Money",
                                                "statusRequest": 200
                                            }

Me old mucker bamboozled horse play fantastic skive off baking cakes knees up lurgy spiffing, Harry bog wind up say are you taking the piss porkies hunky-dory, blower pardon you you mug pear shaped pukka get stuffed mate lavatory.

Related Reading:Child Theming for Layers

Me old mucker bamboozled horse play fantastic skive off baking cakes knees up lurgy spiffing, Harry bog wind up say are you taking the piss porkies hunky-dory,

Related Reading:Child Theming for Layers
Footnote Name A
Lorem ipsum dolor, sit amet consectetur adipisicing elit. Amet voluptas dicta dolor.
Footnote Name B [PDF]
Lorem ipsum dolor, sit amet consectetur adipisicing elit. Amet voluptas dicta dolor.
Footnote Name C
Lorem ipsum dolor, sit amet consectetur adipisicing elit. Amet voluptas dicta dolor.