Consulter un lien de paiement
curl --request GET \
--url https://i-pay.money/api/v1/external_payments/{reference}const options = {method: 'GET'};
fetch('https://i-pay.money/api/v1/external_payments/{reference}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://i-pay.money/api/v1/external_payments/{reference}"
response = requests.get(url)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://i-pay.money/api/v1/external_payments/{reference}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://i-pay.money/api/v1/external_payments/{reference}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.get("https://i-pay.money/api/v1/external_payments/{reference}")
.asString();{
"reference": "<string>",
"amount": 123,
"country": "<string>",
"currency": "<string>",
"transaction_id": "<string>",
"msisdn": "<string>",
"customer_name": "<string>",
"status": "succeeded",
"created_at": "2023-11-07T05:31:56Z"
}{
"message": "<string>",
"status": "failed"
}Consulter un lien de paiement
Lisez l’état d’un lien de paiement à partir de sa référence. Aucune clé n’est requise.
GET
/
external_payments
/
{reference}
Consulter un lien de paiement
curl --request GET \
--url https://i-pay.money/api/v1/external_payments/{reference}const options = {method: 'GET'};
fetch('https://i-pay.money/api/v1/external_payments/{reference}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://i-pay.money/api/v1/external_payments/{reference}"
response = requests.get(url)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://i-pay.money/api/v1/external_payments/{reference}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://i-pay.money/api/v1/external_payments/{reference}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.get("https://i-pay.money/api/v1/external_payments/{reference}")
.asString();{
"reference": "<string>",
"amount": 123,
"country": "<string>",
"currency": "<string>",
"transaction_id": "<string>",
"msisdn": "<string>",
"customer_name": "<string>",
"status": "succeeded",
"created_at": "2023-11-07T05:31:56Z"
}{
"message": "<string>",
"status": "failed"
}Cette opération ne demande aucune clé. Toute personne qui connaît la référence peut consulter l’état du lien et, une fois un paiement complété, les informations du payeur qu’il contient. Générez toujours cette référence de façon aléatoire et à forte entropie (voir Créer un lien de paiement hébergé), et ne la journalisez ni ne l’affichez dans un contexte accessible à un tiers non concerné par ce paiement.
- Forme de la réponse. Elle dépend de l’état réel du lien : un paiement mené à son terme, un lien encore en attente d’un premier essai de paiement, ou un lien expiré sans paiement complété. Un remboursement effectué après coup ne modifie pas cette forme : cette opération n’est pas un indicateur fiable pour détecter un remboursement.
- Lien expiré. Passé le délai de trente minutes sans paiement complété, la consultation répond toujours
200, avechas_expireàtrueetstatusàcancelled. Traitez cette forme comme un lien définitivement inutilisable, et non comme une erreur transitoire à retenter. - Référence inconnue. Une référence qui ne correspond à aucun lien renvoie
404. Comme l’opération est publique, une énumération par force brute est possible si la référence n’est pas assez aléatoire : c’est la raison de l’avertissement ci-dessus.
Path Parameters
Référence privée à forte entropie, non publiée côté client.
Minimum string length:
32Response
État du lien ou du paiement associé
- Option 1
- Option 2
- Option 3
Forme renvoyée lorsqu'un paiement a été mené à son terme pour ce lien. status ne peut alors valoir que succeeded ou failed : sur cette opération, jamais initiated, pending ni refunded. Cas limite : un paiement remboursé après coup n'est plus rattaché au lien, et l'opération renvoie alors la forme d'un lien encore en attente (status: initiated) au lieu d'exposer le remboursement — ne pas utiliser cette opération comme indicateur fiable de remboursement.
