Perguntas frequentes

Conta e adesão

Quanto tempo demora a abrir uma conta?

O registo demora alguns minutos. O resultado da análise KYC é comunicado quando o processo está completo (documentos de registo da empresa, documento de identificação do administrador, dados da conta bancária). Veja Integrar na Serra Leoa (em inglês).

Que documentos pede o KYC?

Três níveis progressivos de verificação determinam as operações que pode realizar:

Nível	Documentos
1	Número de telefone verificado
2	Nível 1 + documento de identificação + selfie
3	Nível 2 + dados da conta bancária + comprovativo de morada

Os limites de cada nível são mostrados no painel quando a conta é ativada.

O meu processo KYC foi recusado, o que faço?

O painel mostra o motivo. Carregue os documentos corrigidos na secção KYC. Sem penalização nem período de espera.

Tarifas

Quanto custa a SOAMTAR?

As comissões e condições comerciais constam do seu contrato de comerciante e podem ser consultadas nas definições do painel.

Quando recebo o meu dinheiro?

O prazo de liquidação depende do canal de pagamento. O prazo efetivo é mostrado no painel, onde também pode definir um limiar mínimo de liquidação. As liquidações são feitas para a sua conta bancária na Serra Leoa (número de conta: a Serra Leoa não utiliza IBAN).

Técnica

Porque devo enviar uma Idempotency-Key?

Para não cobrar duas vezes a um cliente após um tempo de espera de rede. Sem uma chave explícita, a SOAMTAR deriva uma a partir do seu merchant_ref; enviar a sua própria chave dá-lhe um controlo preciso. Veja Idempotência (em inglês).

O que deve responder o meu endpoint de webhook?

Qualquer 2xx em poucos segundos. O corpo é ignorado. Qualquer outro código, ou um tempo de espera esgotado, provoca uma repetição.

Quantas repetições tem um webhook?

Até 5 tentativas: o envio inicial e depois repetições após 60 s, 5 min, 30 min e 2 h. Após várias falhas seguidas, o endpoint é suspenso e recebe um email.

Como reenvio um webhook manualmente?

Painel → Webhooks → Registos → clique em Resend na linha.

Posso ter vários endpoints de webhook?

Sim. Cada endpoint tem o seu próprio segredo e o seu próprio filtro de eventos.

E se perder o meu segredo de webhook?

Faça a rotação a partir do painel; o novo segredo é mostrado uma única vez. Também pode obtê-lo com GET/v1/webhooks/{endpoint_id}/secret usando a sua chave secreta (protegido por OTP em modo live a partir do painel).

As chaves de teste e as chaves live veem os mesmos dados?

Não. Cada chave só vê os objetos do seu próprio modo: uma chave de teste não consegue ler um objeto live e vice-versa.

Posso repetir uma transação do sandbox em produção?

Não. O mesmo merchant_ref pode existir nos dois ambientes (a unicidade depende do modo), mas os identificadores são distintos.

Que formato de número de telefone?

E.164: +232 seguido do número nacional de 8 dígitos, por exemplo +23276000001. Sem espaços nem hífenes. Os pagamentos de saída exigem o + inicial.

Casos de negócio

Como uso um Hosted Checkout sem backend?

Crie uma ligação de pagamento no painel. Pode partilhar o URL diretamente (WhatsApp, SMS, email).

Um cliente na Serra Leoa pode pagar em USD ou EUR?

A API aceita SLE, USD e EUR. O Orange Money Serra Leoa cobra em leones; quando a moeda pedida é diferente, a taxa de câmbio é fixada no início do pagamento.

Quantos splits por transação?

São suportados vários beneficiários. Para um número elevado de beneficiários, contacte o suporte.

Posso reembolsar um pagamento Orange Money?

Sim. POST/v1/refunds com o transaction_id do pagamento (e um amount opcional para um reembolso parcial; sem amount, é reembolsado todo o montante restante). O montante é creditado no número Orange Money do pagador e debitado do seu saldo; o resultado chega pelos webhooks refund.success / refund.failed. Ver Reembolsos (em inglês).

Posso cobrar uma subscrição com Orange Money?

Ainda não com débitos automáticos: a tokenização do dinheiro móvel não está disponível. As subscrições podem funcionar com um pedido de pagamento enviado ao cliente em cada ciclo de faturação.

Como cancelo uma subscrição?

DELETE/v1/subscriptions/{id} (imediato) ou ?at_period_end=true (no fim do ciclo em curso).

Conformidade

A SOAMTAR é regulada?

A SOAMTAR opera na Serra Leoa com o Orange Money Serra Leoa como canal de pagamento e aplica controlos AML (monitorização das transações, comunicação de atividades suspeitas). A informação regulamentar está disponível, mediante pedido, para os comerciantes institucionais.

Os fundos dos comerciantes estão protegidos?

Os fundos a aguardar liquidação são registados em contas dedicadas, separadas dos fundos operacionais da empresa.

A SOAMTAR guarda palavras-passe do Orange Money?

Não. A SOAMTAR utiliza a API de comerciante do Orange Money com credenciais dedicadas, nunca os PIN nem as credenciais dos seus pagadores.

Ajuda

Como contacto o suporte?

• Email: support@so-amtar.com
• Chat do painel: disponível em horário de expediente (hora de Freetown, GMT)