Abrir portal de método de pago
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>"
}Facturación
Abrir portal de método de pago
Cree un enlace de portal de Stripe de corta duración para una cuenta de facturación iniciada.
POST
/
v1
/
billing
/
portal
Abrir portal de método de pago
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>"
}Utilice esta acción desde Console → Configuración → Facturación → Métodos de pago o su
página de facturación del consumidor. Requiere una sesión humana iniciada. Las claves API no pueden abrir
un portal de clientes. Los espacios de trabajo empresariales requieren un administrador de espacio de trabajo activo
o un rol a nivel de inquilino con permiso de gestión de facturación.
Para un espacio de trabajo basado en el uso sin un cliente de Stripe vinculado, el portal explícito
la solicitud inicializa y vincula a ese cliente utilizando el correo electrónico de la cuenta verificada.
Abrir el portal no carga una tarjeta, no crea una suscripción ni cambia el plan.
Solicitud
Establezcaprovider en stripe (el valor predeterminado). Flutterwave no proporciona actualmente un
portal de autoservicio a través de este endpoint. Paystack no es compatible aquí.
Establezca return_url en una dirección HTTPS en console.truthlocks.com para una empresa
sesión o verify.truthlocks.com para una sesión de consumidor. Otros hosts son rechazados.
Respuesta
portal_url es un enlace de Stripe de corta duración. Ábralo para agregar o actualizar los detalles de pago
y ver las facturas de Stripe disponibles. La configuración del portal de métodos de pago de Truthlocks
no permite cambios o cancelaciones de suscripción; use la página de facturación apropiada
página para esas acciones. Trate este enlace como privado y solicite uno nuevo cada vez.
Errores
Los errores devuelven JSON concode y error. 403 significa que la persona que ha iniciado sesión no puede
administrar esta cuenta de facturación. 422 identifica un proveedor no compatible. 502 o
503 indica una falla del proveedor o del servicio de cuenta; el mensaje explica el
siguiente paso. Una búsqueda de cuenta fallida no crea otro cliente proveedor.Cuerpo
application/json

