IOSOR Guias
O envio do usuário final ainda debita de um único livro-razão pré-pago
O envio incorporado ainda debita a carteira pré-paga do ISV. Não invente um segundo livro-razão que o produto não financia: retenções, retries e idempotência permanecem honestos.
As mensagens incorporadas parecem gratuitas para o usuário final: ele clica em Enviar na interface do SaaS e vê uma confirmação verde. Por baixo da superfície, cada envio bem-sucedido continua debitando de um único livro-razão pré-pago mantido pelo ISV. Não existe uma segunda carteira que surge apenas porque o produto incorporou uma API. Se o ISV não financiar as retenções de saldo, o envio deve falhar com um erro real de produto e nunca com um estado falso de entrega.
A contabilidade fictícia é o modo de falha típico: um medidor de créditos no aplicativo que não é respaldado pela carteira IOSOR, reembolsos no SaaS enquanto o livro-razão pré-pago é consumido, ou retries sem idempotência que debitam duas vezes um único OTP.
Um único livro-razão, mesmo quando a UI mostra créditos do produto
Pacotes de mensagens vendidos aos clientes fazem parte da camada comercial do ISV. Eles devem ser mapeados diretamente para retenções e débitos pré-pagos na carteira única IOSOR financiada pelo ISV. Um saldo de cliente que nunca é reconciliado com as linhas do livro-razão torna-se um passivo crítico para a equipe de suporte.
Retenções e idempotência ainda se aplicam em caminhos incorporados
O envio no lado do servidor deve obrigatoriamente utilizar chaves de idempotência para SMS transacional e códigos OTP. Um clique duplo na interface do SaaS não pode gerar dois débitos para uma única ação do usuário. Os retries após um tempo limite devem utilizar a mesma chave até receber um DLR final ou uma falha mapeada.
Mapeie erros do produto para a verdade do livro-razão
| Sinal da UI do SaaS | Verdade do livro-razão | Próximo passo permitido |
|---|---|---|
| Enviado / Entregue | Débito + caminho DLR existente | Exibir ID do comprovante |
| Na fila | Retenção aberta ou envio aceito | Consultar status |
| Falha / Pausado | Retenção rejeitada ou bloqueio ativo | Tentar novamente apenas com nova intenção |
| Sucesso falso | Sem débito / sem retenção | Estritamente proibido |
Transferências de canal permanecem na mesma carteira
Se o produto posteriormente adicionar e-mail ou voz ao lado do SMS, os gastos continuarão sendo debitados do mesmo livro-razão pré-pago, a menos que seja feita uma transferência formal de canal aprovada pelo setor financeiro. A integração não cria um canal secundário gratuito. Leia sobre a adjacência da carteira antes de ativar outro painel na configuração do SaaS.
Caminhos operacionais relacionados
- Segundo canal na carteira: transferência de gastos
- idempotência, retries e dinheiro
- Aplicação segura de limites de taxa em contas multi-inquilino
Comece com a IOSOR
Abra o Console IOSOR e mapeie o sistema de créditos do seu locatário diretamente para o razão principal da carteira pré-paga. Garanta que todas as solicitações de incorporação no lado do servidor passem uma chave de idempotência determinística antes de aplicar uma retenção na carteira mestre. Configure seu ponto de extremidade de webhook para processar os DLRs de entrada, de modo que as retenções abertas sejam resolvidas de forma limpa em débitos ou liberações finais do razão.
Conclusão IOSOR
Uma interface SaaS incorporada pode apresentar créditos de mensagens personalizados aos usuários finais, mas cada envio real se vincula ao único razão pré-pago financiado pelo ISV. Tentativas, expansões de canal e sinais de status do usuário devem reconciliar-se diretamente com as retenções da carteira, em vez de abstrações de interface não respaldadas.
Exija chaves estritas de idempotência no lado do servidor e mapeie cada estado de interface do locatário para respostas reais de DLR do razão. Não crie carteiras secundárias sem respaldo nem permita que tentativas de interface do locatário sejam executadas sem retenções concretas no razão.
Este guia foi útil?
Guias relacionados
- Incorporar a API versus um portal de parceiros white-label
Produtos SaaS que incorporam mensagens permanecem na interface do ISV. Portais de parceiros white-label ficam em Partner — não misture marca, chaves e propriedade operacional.
- Quando o limite de um inquilino integrado deve interromper o envio
Os limites de compartilhamento justo em um produto ISV devem bloquear estritamente o envio desse inquilino sem retornar um API 200 falso.