Guide utilisateur

Pour commencer à utiliser MyAgency Pay, vous devez créer un compte associé à votre organisation. L'inscription se compose de l'enregistrement de vos informations professionnelles, de la définition d'un mot de passe sécurisé et de l'acceptation des conditions d'utilisation.

Étapes de l'inscription

1. 1

   Renseignez les informations de votre organisation

   Remplissez le formulaire avec les données de votre entreprise : nom officiel, adresse e-mail professionnelle, ville et statut juridique.

2. 2

   Définissez un mot de passe sécurisé

   Choisissez un mot de passe conforme aux exigences de sécurité (voir ci-dessous).

3. 3

   Confirmez le mot de passe

   Ressaisissez le mot de passe pour éviter toute erreur de saisie.

4. 4

   Acceptez les conditions

   Cochez la case pour accepter les conditions générales d'utilisation.

5. 5

   Validez l'inscription

   Cliquez sur S'inscrire. Votre compte est créé et un e-mail de vérification vous est envoyé.

Champs du formulaire

Lors de la création de votre compte, MyAgency Pay envoie un e-mail de vérification à l'adresse que vous avez fournie. Cette étape est indispensable pour activer votre compte.

Procédure de vérification

1. 1

   Ouvrez votre boîte de réception

   Repéchez l'e-mail envoyé par MyAgency Pay avec pour objet « Vérification de votre adresse e-mail ».

2. 2

   Cliquez sur le lien de vérification

   Le lien contient un jeton de vérification valide pendant une durée limitée.

3. 3

   Confirmation

   La page affiche « Adresse e-mail vérifiée avec succès ! ». Vous pouvez désormais vous connecter.

Connectez-vous à votre espace MyAgency Pay en renseignant votre adresse e-mail et votre mot de passe.

Étapes de connexion

1. 1

   Saisissez votre adresse e-mail

   Utilisez l'adresse e-mail associée à votre compte MyAgency Pay.

2. 2

   Saisissez votre mot de passe

   Entrez le mot de passe défini lors de la création du compte.

3. 3

   Cliquez sur « Se connecter »

   Vous êtes redirigé vers le tableau de bord correspondant à votre rôle (administrateur ou membre).

Champs du formulaire

Si vous avez oublié votre mot de passe, MyAgency Pay vous permet de le réinitialiser en quelques étapes, depuis votre adresse e-mail.

Procédure de réinitialisation

1. 1

   Saisissez votre adresse e-mail

   Entrez l'adresse e-mail associée à votre compte, puis cliquez sur Envoyer.

   /auth/reset-password

2. 2

   Vérifiez votre boîte mail

   Un e-mail contenant un lien de réinitialisation vous est envoyé. Cliquez sur ce lien.

   /auth/reset-password/check-email?email=...

3. 3

   Définissez un nouveau mot de passe

   Choisissez un mot de passe sécurisé et confirmez-le. Le lien contient un jeton temporaire valide.

   /auth/reset-password/change?token=...

4. check

   Mot de passe mis à jour

   Un message de confirmation s'affiche. Vous pouvez maintenant vous connecter avec votre nouveau mot de passe.

   /auth/reset-password/changed

Étape 1 — Saisie de l'e-mail

Étape 2 — Vérifiez votre boîte mail

Étape 3 — Confirmation

Une fois connecté, vous arrivez sur votre tableau de bord. Il regroupe un aperçu de votre portefeuille, de vos boutiques et de l'évolution de vos transactions.

Mon portefeuille

Cette section affiche les montants disponibles par moyen de paiement.

• account_balance_wallet Solde total disponible — le montant agrégé (en MGA) de tous vos fonds disponibles.
• phone_android MVola — montant disponible sur le moyen de paiement MVola.
• phone_android Orange Money — montant disponible sur le moyen de paiement Orange Money.

Mon Boutique

Un récapitulatif rapide de vos boutiques : identifiant de la boutique principale, nombre total de boutiques, et répartition par mode (live / sandbox).

Évolution des transactions

Un graphique du nombre de transactions par jour et par moyen de paiement. Vous pouvez filtrer l'affichage par boutique, mode (live/sandbox), type de paiement et période.

La page Boutique vous permet de créer vos commerces, de les modifier et d'y configurer les moyens de paiement acceptés.

Liste des boutiques

Le tableau liste l'ensemble de vos boutiques avec leurs informations principales :

• filter_altUn filtre « Mode : Tous » permet de filtrer par mode (live / sandbox).
• add_circleLe bouton « Ajouter » ouvre le formulaire de création de boutique.

Créer une boutique

Rendez-vous sur la page de création et renseignez les informations suivantes :

Terminez avec Enregistrer (ou Annuler pour abandonner). La boutique apparaît ensuite dans la liste.

Modifier une boutique

Depuis la liste, ouvrez la boutique via « Afficher » puis modifiez ses paramètres. La page d'édition contient :

• infoInformations générales — nom et description de la boutique.
• paymentsTypes de paiement acceptés — activez/désactivez MVola et Orange Money.
• toggle_onStatut — actif ou inactif.
• scienceMode d'environnement — live ou sandbox.
• vpn_keyClés API — clés Sandbox et Live dédiées à la boutique.

La page Transaction centralise l'ensemble des paiements réalisés sur vos boutiques, avec le détail des montants, frais et net marchand.

Colonnes du tableau

Filtres et affichage

Les boutons Filtres et Colonnes permettent de personnaliser la vue du tableau. Les filtres disponibles sont :

Validez vos critères avec le bouton Appliquer. La pagination (par page, ex. 10 lignes) permet de parcourir les résultats.

La page Demande de retrait vous permet de retirer les fonds disponibles de votre portefeuille vers vos moyens de paiement configurés.

Effectuer une demande de retrait

1. 1

   Cliquez sur « Ajouter »

   Une fenêtre « Moyen de paiement de retrait » s'ouvre.

2. 2

   Sélectionnez votre moyen de paiement

   Choisissez le compte de retrait vers lequel les fonds seront dirigés.

3. 3

   Validez la demande

   La demande apparaît dans la liste avec son statut et peut être filtrée.

Liste des demandes

Le tableau récapitule vos demandes de retrait passées. Les boutons Filtres et Réinitialiser vous aident à retrouver une demande en particulier.

La page Compte de retrait vous permet de renseigner les numéros (MVola et Orange Money) sur lesquels vos fonds seront transférés lors de vos demandes de retrait.

Moyens de paiement de retrait

La page Configuration permet de modifier les coordonnées et informations de votre organisation.

Onglets

La page est organisée en deux onglets : Informations et Documents. Sur l'onglet Informations, trois blocs sont à renseigner.

Enregistrez vos modifications avec Enregistrer ou quittez avec Annuler.

MyAgency Pay propose deux environnements distincts pour garantir des tests sécurisés avant la mise en production. L'API REST est accessible depuis une URL unique : l'environnement est déterminé par la clé utilisée.

Les endpoints marchands de MyAgency Pay — création d'intention de paiement et de transaction — ne sont pas signés avec un simple JWT. Ils utilisent un mécanisme de signature HMAC-SHA256 du payload reposant sur trois en-têtes qui doivent être présents sur chaque requête :

Comment calculer la signature ?

La signature X-Signature est l'empreinte HMAC-SHA256 d'un message construit ainsi :

message = "<X-Timestamp>\n<body>"
signature = base64url( hmac_sha256( secret = clé_secrète, data = message ) )

• check_circle X-Timestamp est suivi d'un retour à la ligne (\n) puis du corps de la requête brut et à l'identique.
• check_circle Le secret de l'empreinte est la clé secrète associée au Bearer, pas l'apiKey publique.
• check_circle Le body signé doit être strictement identique (octet pour octet) au corps réellement envoyé dans la requête : ne signez pas une version reformatée du JSON.
• check_circle Le résultat est encodé en base64url (mêmes caractères que le base64, avec - et _ à la place de + et /, sans padding =).

Quel secret pour quel endpoint ?

Le mode (sandbox ou live) est choisi automatiquement par le serveur selon la clé utilisée : une clé pk_sandbox_… place la requête en environnement sandbox.

Pourquoi ce système est-il sécurisé ?

Initialisez une intention de paiement via l'API REST de MyAgency Pay. Cette première étape crée un paiement unique pour un client : la suite du déroulé se fait sur la page de paiement hébergée.

En-têtes requis

Le Bearer et le secret de l'empreinte sont la clé de boutique (pk_). Le message signé est <X-Timestamp>\n<body> — voir la section Authentification HMAC.

Corps de la requête

{
  "customer": "client-123",
  "amount": 10000,
  "currency": "MGA",
  "order_ref": "CMD-2025-001",
  "success_url": "https://votre-app.com/paiement/reussi",
  "failed_url": "https://votre-app.com/paiement/echoue",
  "notification_url": "https://votre-app.com/webhook/paiement",
  "metadata": { "produit": "Abonnement premium" }
}

# 1. Calculer la signature HMAC-SHA256
TIMESTAMP=$(date +%s)
BODY='{"customer":"client-123","amount":10000,"currency":"MGA","order_ref":"CMD-2025-001","success_url":"https://votre-app.com/success","failed_url":"https://votre-app.com/failed","notification_url":"https://votre-app.com/webhook/paiement","metadata":{"produit":"Abonnement premium"}}'
MESSAGE="${TIMESTAMP}
${BODY}"
SIGNATURE=$(printf '%s' "$MESSAGE" \
  | openssl dgst -sha256 -hmac pk_sandbox_xxxxxxxxxxxxxxxxxxxx \
  | sed 's/^.* //; s/[+\/=-]/_/g; s/__\+//')
# → ou utilisez un script Python/PHP pour le base64url

# 2. Envoyer la requête
curl -X POST https://api-pay.altivane.io/api/payment-intents \
  -H "Authorization: Bearer pk_sandbox_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Signature: ${SIGNATURE}" \
  -d "$BODY"

<?php
// Clé de boutique (pk_sandbox_ ou pk_live_)
$storeKey = "pk_sandbox_xxxxxxxxxxxxxxxxxxxx";

// Corps de la requête
$body = [
    "customer"          => "client-123",
    "amount"            => 10000,
    "currency"          => "MGA",
    "order_ref"         => "CMD-2025-001",
    "success_url"       => "https://votre-app.com/success",
    "failed_url"        => "https://votre-app.com/failed",
    "notification_url"  => "https://votre-app.com/webhook/paiement",
    "metadata"          => ["produit" => "Abonnement premium"],
];

$bodyJson = json_encode($body, JSON_UNESCAPED_SLASHES
                        | JSON_UNESCAPED_UNICODE
                        | JSON_THROW_ON_ERROR);

// ── Sécurisation HMAC ──
$timestamp = time();                             // secondes Unix
$message   = $timestamp . "\n" . $bodyJson;      // X-Timestamp + LF + body
$signature = rtrim(strtr(base64_encode(           // base64url
    hash_hmac('sha256', $message, $storeKey, true),
), '+/', '-_'), '=');

// ── Appel API ──
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL            => "https://api-pay.altivane.io/api/payment-intents",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $bodyJson,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer {$storeKey}",
        "Content-Type: application/json",
        "X-Timestamp: {$timestamp}",
        "X-Signature: {$signature}",
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

// → Réponse JSON avec id pi_…, url_pay, etc.
$datas     = json_decode($response, true);
$urlPayment = $datas['data']['url_pay'] ?? null;

Réponse

En cas de succès (HTTP 201), le serveur renvoie l'intention de paiement créée avec son identifiant pi_… — indispensable pour la signature de la transaction suivante : conservez-le.

{
  "success": true,
  "data": {
    "id": "pi_8f3c2d1e4a5b6c7d8e9f0a1b",
    "amount": 10000,
    "currency": "MGA",
    "order_ref": "CMD-2025-001",
    "url_pay": "https://app-pay.altivane.io/pay?pi=pi_"
  },
  "message": "Payment intent créé avec succès"
}

Choisissez l'intégration adaptée à votre boutique. Les intégrations utilisent la même API de paiement et conservent les signatures HMAC de la section Authentification HMAC.

const response = await fetch('/api/payment-intents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(order)
});

const { data } = await response.json();
window.location.assign(data.url_pay);

<script src="https://cdn.example.com/MyAgency Pay/latest/MyAgency Pay.js" defer></script>
<script>
  window.addEventListener('DOMContentLoaded', () => {
    MyAgency Pay.init({ checkoutUrl: '/checkout' });
  });
</script>

Aucun endpoint de création de transaction n'est nécessaire : lors de la création de l'intention (section Créer un paiement), le serveur renvoie une URL de paiement hébergée qui s'ouvre dans le navigateur du client.

Exemple : https://app-pay.altivane.io/pay?pi=pi_xxxxxxxxxxxxxxx

Comment ça fonctionne ?

Chaque paiement validé par le client crédite le portefeuille de votre organisation. Le règlement correspond à l'encaissement de ces fonds : vous consultez votre solde puis demandez un virement vers votre compte de retrait, sans manipulation supplémentaire de part et d'autre.

Suivi du règlement

La page Demande de retrait (https://app-pay.altivane.io/transfers) récapitule toutes vos demandes : montant, moyen de paiement de retrait, statut et date. La page Compte de retrait indique le numéro vers lequel seront versés vos futurs virements.