Authentification

L'authentification se fait via une clé API fournie dans l'en-tête : Authorization: Bearer VOTRE_CLÉ_API.

Type de requête : POST

URL d’appel : https://paylink.pixelinnov.net/api/create-link

Paramètres du Corps de la Requête (Body)

Précisions sur les paramètres

L'objet `services`

Ce tableau définit les options de paiement à proposer au client.

Exemple Complet : Options Avancées

{
  "type": 0,
  "amount": 5,
  "description": "Achat crédit téléphonique",
  "customer_name": "eudes",
  "callback_url": "https://votresite.com/confirmation",
  "expired_at": "2025-09-15T23:59:59Z",
  "allow_comment": true,
  "comment_titles": ["Numéro client", "Référence"],
  "services": [
    {
      "countryCode": "CI",
      "operatorNames": ["Orange", "Wave"]
    },
    {
      "countryCode": "SN",
      "operatorNames": ["Wave"]
    }
  ]
}

Clarification sur l'OTP

Le paramètre `om_otp` n'est pas utilisé lors de la création du lien de paiement. La validation par OTP, si nécessaire, se fait par le client final sur la page de paiement générée par le lien.

Exemple de Réponse (Succès)

Si la requête est valide, l'API retourne une réponse avec le statut et le lien de paiement généré.

{
    "data": {
        "id": 424,
        "p_id": 93,
        "customer_name": "Confort_XAFf",
        "token": "************************************************************",
        "link": "pay.paylink.sn/payment/v1/************************************************************",
        "type": "0",
        "amount": 200,
        "amount_min": 0,
        "amount_max": 0,
        "created_at": "2025-09-10T08:36:38.000+00:00",
        "expired_at": null,
        "updated_at": "2025-09-10T08:36:38.000+00:00",
        "is_active": 1
    },
    "message": "link is generated success ...",
    "statut_code": 200
}

Authentification

L'authentification se fait via votre clé API partenaire, fournie dans l'en-tête (header) de la requête. Le format attendu est : Authorization: Bearer VOTRE_CLÉ_API.

Le champ `state` dans la réponse

Le champ `state` dans la réponse finale peut avoir 3 valeurs :

• SUCCESSFUL : Le reversement a été effectué avec succès.
• FAILED : Le reversement a échoué.
• PENDING : Le statut final n'a pas pu être obtenu après 20 secondes. Le statut final sera notifié plus tard sur votre URL d'IPN si elle est configurée.

Paramètres du Corps de la Requête

Exemple de Requête (cURL)

curl --location 'https://paylink.pixelinnov.net/api/public-reversement' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer VOTRE_CLÉ_API' \
--data '{
    "destination": "0778261090",
    "country_code": "CI",
    "operator_name": "wave",
    "amount": 20,
    "recipient_name": "Nom du Bénéficiaire"
}'

Exemple de Réponse (Succès)

{
    "success": true,
    "message": "Reversement public enregistré.",
    "reversement": {
        "_id": "68c15298a5cf56d6867b448f",
        "userId": "6890c8068dc2bddee412bf5c",
        "client_name": "reversement pub paylink",
        "destination": "0778261090",
        "operator_name": "wave",
        "country_code": "CI",
        "amount": 20,
        "transaction_id": "PIXPAY_19275913",
        "state": "SUCCESSFUL",
        "createdAt": "2025-09-10T10:27:36.658Z"
    }
}