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

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