Créer un lien de paiement
curl --request POST \
--url https://api.example.com/v1/payment-linksimport requests
url = "https://api.example.com/v1/payment-links"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.example.com/v1/payment-links', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/payment-links",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/payment-links"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/v1/payment-links")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/payment-links")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyLiens de paiement
Créer un lien de paiement
Créer un lien de paiement réutilisable
POST
/
v1
/
payment-links
Créer un lien de paiement
curl --request POST \
--url https://api.example.com/v1/payment-linksimport requests
url = "https://api.example.com/v1/payment-links"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.example.com/v1/payment-links', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/payment-links",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/payment-links"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/v1/payment-links")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/payment-links")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyCréer un lien de paiement
Crée un lien de paiement partageable, à montant fixe (produit) ou libre (le client saisit le montant).Endpoint
POST /v1/payment-links
Body
| Paramètre | Type | Requis | Description |
|---|---|---|---|
name | string | ✅ | Nom affiché au client (title accepté comme alias) |
description | string | Description | |
amount_mode | string | OPEN (montant libre, défaut) ou FIXED | |
fixed_amount | integer | si FIXED | Montant fixe, 100 à 5 000 000 FCFA (price / amount acceptés comme alias) |
min_amount / max_amount | integer | Bornes en mode OPEN (défaut 100 / 500 000) | |
currency | string | Défaut XOF | |
success_redirect_url | string | URL de retour après paiement (redirect_url accepté comme alias) | |
image_url | string | Image du produit | |
expires_at | string | Date d’expiration ISO 8601 | |
max_uses | integer | Nombre maximal de paiements (1 à 10 000) | |
product_id | string | Partenaires SPAY : produit validé du catalogue (lien FIXED au prix validé, obligatoire en live) |
Exemple
curl -X POST https://api.sahelpay.ml/v1/payment-links \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{
"name": "Abonnement Premium",
"amount_mode": "FIXED",
"fixed_amount": 10000,
"description": "Accès illimité pendant 1 mois",
"success_redirect_url": "https://votre-site.com/merci"
}'
Réponse
data est le lien créé, avec notamment id, slug (32 caractères hexadécimaux), name, amount_mode, fixed_amount, min_amount, max_amount, currency, is_active et created_at.
Utilisation
L’URL publique du lien esthttps://pay.sahelpay.africa/<slug> (les anciennes adresses pay.sahelpay.ml restent servies). Le client y paie par mobile money sur une page hébergée par SahelPay. Les SDKs renvoient cette URL dans le champ url.
Sans
amount_mode, l’API crée un lien à montant libre (OPEN), même si fixed_amount ou price est fourni :
le client peut alors payer n’importe quel montant entre min_amount et max_amount. Envoyez "amount_mode": "FIXED"
pour un prix imposé. Depuis la version 1.1.0, les SDKs envoient FIXED dès qu’un montant est fourni.