Respostas e callbacks do SDK

Cada SDK da DEUNA retorna resultados de interface imediatos através de callbacks. O objeto de sucesso exato depende da experiência aberta, enquanto erros, ações de fechamento, detecção de BIN e seleção de parcelamento usam contratos menores.

Anatomia da respostaPerguntar à Athia sobre isto#

Matriz de callbacksPerguntar à Athia sobre isto#

Tipos Web e React NativePerguntar à Athia sobre isto#

type ClosedAction = 'userAction' | 'systemAction';

type SdkError = {
  type: string;
  metadata: {
    code: string;
    message: string;
  };
};

type CardBinDetected = {
  cardBin: string;
  cardBrand: string;
};

type InstallmentSelected = {
  cardBin: string;
  installmentPlanOptionId: string;
};

type Dimensions = {
  height: number;
  width: number;
};

Gerencie os erros por categoria, mantendo o código do provedor ou da experiência para diagnóstico de suporte:

const callbacks = {
  onSuccess: async (data) => {
    setCheckoutState('verifying');
    const verifiedOrder = await fetch(`/api/orders/${merchantOrderId}`).then(r => r.json());
    renderFromAuthoritativeState(verifiedOrder);
  },
  onError: ({type, metadata}) => {
    logSafeDiagnostic({type, code: metadata.code});
    showRecoveryMessage(type, metadata.code);
  },
  onClosed: (action, metadata) => {
    restorePaymentMethods();
    if (metadata) logSafeDiagnostic({action, code: metadata.code});
  },
};

Tipos de erro nativosPerguntar à Athia sobre isto#

Os SDKs para iOS e Android normalizam os erros de pagamento em PaymentsError com type, opcional metadata, e um opcional order snapshot.

callbacks.onError = { error ->
    val code = error.metadata?.code ?: "UNKNOWN_ERROR"
    logger.warn("DEUNA SDK error", mapOf("type" to error.type.name, "code" to code))
    renderRecovery(error.type)
}

callbacks.onError = { error in
    let code = error.metadata?.code ?? "UNKNOWN_ERROR"
    logger.warning("DEUNA SDK error: \(error.type) / \(code)")
    renderRecovery(error.type)
}

O sucesso é específico da experiênciaPerguntar à Athia sobre isto#

O modelo de pedido evolui independentemente do fluxo de chamadas de retorno do SDK. Use o endpoint da API de referência para o esquema do backend atual, em vez de copiar campos arbitrários de um payload do cliente.

Gerenciamento de redimensionamento integradoPerguntar à Athia sobre isto#

const host = document.querySelector('#deuna-widget');

await DeunaSDK.initPaymentWidget({
  orderToken,
  mode: 'target',
  target: '#deuna-widget',
  callbacks: {
    onResize: ({height}) => {
      host.style.height = `${Math.ceil(height)}px`;
    },
    onSuccess: verifyOrder,
    onError: showRecovery,
  },
});

Garanta que o elemento iframe tenha uma altura mínima estável enquanto carrega, e depois... onResize Atualize-o. Em telas menores, evite uma largura fixa em pixels e permita que o host preencha toda a área da tela.

Verificação de segurançaPerguntar à Athia sobre isto#

• As funções de callback devem ser idempotentes; os sinais de ciclo de vida podem ocorrer durante a navegação ou em tentativas.
• Desativar a submissão duplicada durante onPaymentProcessing e enquanto submit() está pendente.
• Exibir cópias legíveis por humanos a partir de uma lista de permissão. Não expor mensagens brutas do provedor por padrão.
• Log type, código de erro seguro, versão do SDK, ambiente e ID de correlação do comerciante – não credenciais ou dados de cartão.
• Restaurar o foco quando um modal é fechado e anunciar erros por meio de uma área de notificação acessível.
• Verifique o estado atual do pedido após o encerramento ambíguo, tempo limite ou interrupção de rede.

Contratos de código abertoPerguntar à Athia sobre isto#

As estruturas de retorno são verificadas em relação ao estado atual. Interfaces de retorno web, Interfaces de callback React Native, Base de callback para iOSe Callbacks compartilhados para Android. Utilize a versão instalada pela sua aplicação quando um repositório… main A versão da ramificação é mais recente que a versão que você definiu como principal.

Referências relacionadasPerguntar à Athia sobre isto#