Ouvrir le portail de la méthode de paiement
curl --request POST \
--url https://api.truthlocks.com/v1/billing/portal \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"return_url": "https://console.truthlocks.com/settings/billing"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({return_url: 'https://console.truthlocks.com/settings/billing'})
};
fetch('https://api.truthlocks.com/v1/billing/portal', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/billing/portal"
payload = { "return_url": "https://console.truthlocks.com/settings/billing" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/billing/portal"
payload := strings.NewReader("{\n \"return_url\": \"https://console.truthlocks.com/settings/billing\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"portal_url": "<string>"
}Facturation
Ouvrir le portail de la méthode de paiement
Créer un lien de portail Stripe de courte durée pour un compte de facturation connecté.
POST
/
v1
/
billing
/
portal
Ouvrir le portail de la méthode de paiement
curl --request POST \
--url https://api.truthlocks.com/v1/billing/portal \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"return_url": "https://console.truthlocks.com/settings/billing"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({return_url: 'https://console.truthlocks.com/settings/billing'})
};
fetch('https://api.truthlocks.com/v1/billing/portal', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/billing/portal"
payload = { "return_url": "https://console.truthlocks.com/settings/billing" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/billing/portal"
payload := strings.NewReader("{\n \"return_url\": \"https://console.truthlocks.com/settings/billing\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"portal_url": "<string>"
}Utilisez cette action depuis Console → Paramètres → Facturation → Méthodes de paiement ou votre
page de facturation du consommateur. Elle nécessite une session humaine connectée. Les clés API ne peuvent pas ouvrir
un portail client. Les espaces de travail professionnels nécessitent un administrateur d’espace de travail actif
ou un rôle à l’échelle du locataire avec la permission de gestion de la facturation.
Pour un espace de travail basé sur l’utilisation sans client Stripe lié, le portail explicite
la demande initialise et lie ce client en utilisant l’e-mail du compte vérifié.
L’ouverture du portail ne débite pas de carte, ne crée pas d’abonnement et ne modifie pas le plan.
Requête
Définissezprovider sur stripe (la valeur par défaut). Flutterwave ne fournit pas actuellement de
portail en libre-service via ce point de terminaison. Paystack n’est pas pris en charge ici.
Définissez return_url sur une adresse HTTPS sur console.truthlocks.com pour une entreprise
session ou verify.truthlocks.com pour une session consommateur. Les autres hôtes sont rejetés.
Réponse
portal_url est un lien Stripe de courte durée. Ouvrez-le pour ajouter ou mettre à jour les détails de paiement
et consultez les factures Stripe disponibles. La configuration du portail de paiement de Truthlocks
n’active pas les changements d’abonnement ou l’annulation ; utilisez la page de facturation appropriée
page pour ces actions. Traitez ce lien comme privé et demandez-en un nouveau à chaque fois.
Erreurs
Les erreurs renvoient du JSON aveccode et error. 403 signifie que la personne connectée ne peut pas
gérer ce compte de facturation. 422 identifie un fournisseur non pris en charge. 502 ou
503 indique une défaillance du fournisseur ou du service de compte ; le message explique le
étape suivante. Une recherche de compte échouée ne crée pas un autre client fournisseur.Corps
application/json

