Pague por produtos e subscrições
Crie um checkout de carteira, deixe o cliente confirmá-lo no ShareAI e, em seguida, verifique o resultado pago antes da execução.
Nesta página
Ative o Pagar com ShareAI em Casos de Uso. Nos Planos de Subscrição, escolha Publicar acesso gratuito ao pagamento para compras únicas sem subscrição ou sobretaxa de IA. Alternativamente, publique os seus planos de subscrição. Os clientes aceitam este contrato ao conectar a sua carteira; cada pagamento é confirmado separadamente.
Ative o Pagar com ShareAI e obtenha um token OAuth do cliente com payments. Para subscrições, publique um Plano de Subscrição e faça com que o cliente o aceite. Os montantes são strings exatas de crédito de carteira denominadas em EUR; não envie cálculos de ponto flutuante.
https://api.shareai.now/api/v1/console/builder/paymentsCrie um pedido de finalização de compra pendente
- URL Base
https://api.shareai.now- Autenticação
- Token Bearer OAuth do cliente
- Escopo necessário
payments
cURL
curl --fail-with-body 'https://api.shareai.now/api/v1/console/builder/payments' -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" -H 'Content-Type: application/json' -H 'Idempotency-Key: order-2026-09-example-001' --data '{"title":"Research report","amount":"12.50"}'
Finalização de subscrição#
Use o mesmo endpoint e uma nova chave de idempotência para o período de faturação pretendido com {"subscription":true}. O ShareAI utiliza o preço, título e período do plano imutável aceite. O montante do produto enviado por si não pode substituir o preço da subscrição.
Confirmar e verificar#
- Guarde o ID de pagamento e o checkout_url retornados. Repetir o mesmo pedido e chave de idempotência retorna o mesmo pagamento. Reutilizar uma chave com termos diferentes será rejeitado.
- Abra o checkout_url para o cliente. Ele faz login e seleciona a mesma conta pessoal ou organizacional usada durante a autorização.
- O ShareAI exibe a aplicação, compra, montante e pagador. Apenas uma confirmação explícita e autorizada debita a carteira. Abrir o link não realiza a cobrança.
- Leia novamente o pagamento com o mesmo token do cliente. Realize a entrega apenas após o status ser pago; nunca confie apenas numa mensagem de sucesso do navegador.
https://api.shareai.now/api/v1/console/builder/payments?id={payment_id}Leia o pagamento do seu cliente
- URL Base
https://api.shareai.now- Autenticação
- Token Bearer OAuth do cliente
- Escopo necessário
payments
cURL
curl --fail-with-body --get 'https://api.shareai.now/api/v1/console/builder/payments' -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" --data-urlencode "id=$PAYMENT_ID"
| Status | Significado |
|---|---|
| pendente | Aguardando confirmação; o checkout expira após 15 minutos. |
| pago | Confirmado e debitado uma vez. Uma subscrição inclui o fim do período pago. |
| recusado | O cliente recusou. |
| expirado | O período de confirmação terminou. Crie um novo pedido com uma nova chave. |
Apenas créditos de carteira adquiridos, irrestritos e não expirados podem pagar por produtos e subscrições. Créditos promocionais e ganhos exclusivamente de inferência não podem. O pagador não pode pagar para a sua própria conta de Builder. Crédito insuficiente deixa o pagamento sem cobrança; o cliente pode tentar novamente após recarregar enquanto o checkout e a autorização permanecem válidos.
Cada renovação requer um novo checkout e confirmação do cliente. Um período de subscrição ativo não pode ser cobrado duas vezes. A concessão original deve ainda estar ativa no momento da confirmação; atualize tokens expirados e crie um novo pedido, se necessário.
Os pedidos estão vinculados ao cliente OAuth e ao cliente. Os rendimentos de produtos e subscrições são registados separadamente dos ganhos de sobretaxa de IA e têm um período de revisão de 45 dias. A taxa padrão de 1,5% do Builder aplica-se apenas aos ganhos de sobretaxa de IA.
Console Analytics → Pagamentos lista estados de pagamento, totais diários e estado de liberação. Termos do plano híbrido.
Última atualização em 18 de setembro de 2026