Preguntas frecuentes
Cuenta y alta
¿Cuánto se tarda en abrir una cuenta?
El registro lleva unos minutos. El resultado de la revisión KYC se comunica cuando el expediente está completo (documentos de registro de la empresa, documento de identidad del director, datos de la cuenta bancaria). Vea Integrar en Sierra Leona (en inglés).
¿Qué documentos pide el KYC?
Tres niveles progresivos de verificación determinan las operaciones que puede realizar:
| Nivel | Documentos |
|---|---|
| 1 | Número de teléfono verificado |
| 2 | Nivel 1 + documento de identidad + selfie |
| 3 | Nivel 2 + datos de la cuenta bancaria + justificante de domicilio |
Los límites de cada nivel se muestran en su panel cuando se activa la cuenta.
Mi expediente KYC fue rechazado, ¿qué hago?
El panel muestra el motivo. Suba los documentos corregidos en la sección KYC. Sin penalización ni periodo de espera.
Tarifas
¿Cuánto cuesta SOAMTAR?
Las comisiones y condiciones comerciales figuran en su contrato de comercio y pueden consultarse en los ajustes de su panel.
¿Cuándo recibo mi dinero?
El plazo de liquidación depende del canal de pago. El plazo efectivo se muestra en su panel, donde también puede fijar un umbral mínimo de liquidación. Las liquidaciones se abonan en su cuenta bancaria de Sierra Leona (número de cuenta: Sierra Leona no utiliza IBAN).
Técnica
¿Por qué debería enviar una Idempotency-Key?
Para no cobrar dos veces a un cliente tras un tiempo de espera de red. Sin una clave explícita, SOAMTAR deriva una a partir de su merchant_ref; enviar su propia clave le da un control preciso. Vea Idempotencia (en inglés).
¿Qué debe responder mi endpoint de webhook?
Cualquier 2xx en pocos segundos. El cuerpo se ignora. Cualquier otro código, o un tiempo de espera agotado, provoca un reintento.
¿Cuántos reintentos hay para un webhook?
Hasta 5 intentos: el envío inicial y luego reintentos tras 60 s, 5 min, 30 min y 2 h. Tras varios fallos seguidos, el endpoint se suspende y recibe un correo.
¿Cómo reenvío un webhook manualmente?
Panel → Webhooks → Registros → haga clic en Resend en la línea.
¿Puedo tener varios endpoints de webhook?
Sí. Cada endpoint tiene su propio secreto y su propio filtro de eventos.
¿Qué pasa si pierdo mi secreto de webhook?
Haga una rotación desde el panel; el nuevo secreto se muestra una sola vez. También puede recuperarlo con GET/v1/webhooks/{endpoint_id}/secret usando su clave secreta (protegido por OTP en modo live desde el panel).
¿Ven las claves de prueba y las claves live los mismos datos?
No. Cada clave solo ve los objetos de su propio modo: una clave de prueba no puede leer un objeto live y viceversa.
¿Puedo repetir una transacción de sandbox en producción?
No. El mismo merchant_ref puede existir en los dos entornos (la unicidad depende del modo), pero los identificadores son distintos.
¿Qué formato de número de teléfono?
E.164: +232 seguido del número nacional de 8 cifras, por ejemplo +23276000001. Sin espacios ni guiones. Los pagos salientes exigen el + inicial.
Casos de negocio
¿Cómo uso un Hosted Checkout sin backend?
Cree un enlace de pago desde el panel. Puede compartir la URL directamente (WhatsApp, SMS, correo).
¿Puede un cliente en Sierra Leona pagar en USD o EUR?
La API acepta SLE, USD y EUR. Orange Money Sierra Leona cobra en leones; cuando la divisa solicitada es distinta, el tipo de cambio se fija al iniciar el pago.
¿Cuántos splits por transacción?
Se admiten varios beneficiarios. Para un número elevado de beneficiarios, contacte con el soporte.
¿Puedo reembolsar un pago con Orange Money?
Sí. POST/v1/refunds con el transaction_id del pago (y un amount opcional para un reembolso parcial; sin amount, se reembolsa todo el importe restante). El importe se abona al número Orange Money del pagador y se descuenta de su saldo; el resultado llega por los webhooks refund.success / refund.failed. Ver Reembolsos (en inglés).
¿Puedo cobrar una suscripción con Orange Money?
Todavía no con débitos automáticos: la tokenización del dinero móvil no está disponible. Las suscripciones pueden funcionar con una solicitud de pago enviada al cliente en cada ciclo de facturación.
¿Cómo cancelo una suscripción?
DELETE/v1/subscriptions/{id} (inmediato) o ?at_period_end=true (al final del ciclo en curso).
Cumplimiento
¿Está SOAMTAR regulado?
SOAMTAR opera en Sierra Leona con Orange Money Sierra Leona como canal de pago y aplica controles AML (vigilancia de las transacciones, declaración de actividades sospechosas). La información reglamentaria está disponible, previa solicitud, para los comercios institucionales.
¿Están protegidos los fondos de los comercios?
Los fondos pendientes de liquidación se registran en cuentas dedicadas, separadas de los fondos operativos de la empresa.
¿Guarda SOAMTAR contraseñas de Orange Money?
No. SOAMTAR utiliza la API de comercio de Orange Money con credenciales dedicadas, nunca los PIN ni las credenciales de sus pagadores.
Ayuda
¿Cómo contacto con el soporte?
- Correo:
support@so-amtar.com - Chat del panel: disponible en horario de oficina (hora de Freetown, GMT)