Abrir portal de método de pagamento
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>"
}Faturamento
Abrir portal de método de pagamento
Crie um link de portal Stripe de curta duração para uma conta de faturamento logada.
POST
/
v1
/
billing
/
portal
Abrir portal de método de pagamento
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>"
}Use esta ação em Console → Configurações → Cobrança → Métodos de pagamento ou seu
página de faturamento do consumidor. Requer uma sessão humana autenticada. Chaves de API não podem abrir
um portal do cliente. Espaços de trabalho empresariais exigem um administrador de espaço de trabalho ativo
ou uma função em todo o locatário com permissão de gerenciamento de faturamento.
Para um espaço de trabalho baseado em uso sem um cliente Stripe vinculado, o portal explícito
solicitação inicializa e vincula esse cliente usando o e-mail da conta verificada.
Abrir o portal não cobra um cartão, não cria uma subscrição, nem altera o plano.
Solicitação
Definaprovider como stripe (o padrão). O Flutterwave atualmente não fornece um
portal de autoatendimento através deste endpoint. Paystack não é suportado aqui.
Defina return_url para um endereço HTTPS em console.truthlocks.com para uma empresa
sessão ou verify.truthlocks.com para uma sessão de consumidor. Outros hosts são rejeitados.
Resposta
portal_url é um link Stripe de curta duração. Abra-o para adicionar ou atualizar detalhes de pagamento
e visualize as faturas Stripe disponíveis. A configuração do portal de método de pagamento da Truthlocks
não permite alterações ou cancelamento de assinatura; use a página de faturamento apropriada
página para essas ações. Trate este link como privado e solicite um novo a cada vez.
Erros
Erros retornam JSON comcode e error. 403 significa que a pessoa logada não pode
gerenciar esta conta de faturamento. 422 identifica um provedor não suportado. 502 ou
503 indica uma falha do provedor ou do serviço de conta; a mensagem explica o
próximo passo. Uma falha na pesquisa de conta não cria outro cliente provedor.Corpo
application/json

