To test the Transaction API, generate an API key from your partner space in the RichattPay application.
Once you have obtained this key, insert it into a GET request to view the list of potential errors via the following URL:
{{base_url}}/api-services/v2/transaction/errors
Headers
| Parameter Name | Value | Mandatory | Description |
|---|---|---|---|
| apikey | String | Yes | your API key (provided by RichattPay) |
| Accept-Language | en: default fr | An optional indicator to specify the preferred language. |
This endpoint allows you to retrieve the list of potential errors that may occur during a transaction submission. It provides detailed information about the types of errors you might encounter, whether they are related to the provided data, connection issues, or service-specific restrictions.
Example of successful response
The response will be an object containing the list of errors.
{
"succes": true,
"errorslist": [
{
"id": 0,
"code": "unknown_error",
"message": "Votre opération n'a pas pu être traitée pour le moment, réessayez plus tard."
},
{
"id": 1,
"code": "invalid_phone_number",
"message": "Le numéro Bankily que vous avez saisie est incorrect"
},
{
"id": 3,
"code": "logged-out-user-session",
"message": ""
},
{
"id": 4,
"code": "payment-timeout",
"message": "Le client n'a pas validé le paiement après 15 minutes"
},
{
"id": 5,
"code": "no_bankily_account",
"message": "Le destinataire n'est pas un client Bankily"
},
{
"id": 9,
"code": "no_masrivi_account",
"message": "Le destinataire n'est pas un client Masrivi"
},
{
"id": 11,
"code": "user_account_suspended",
"message": "Le compte Bankily du client est suspendu"
},
{
"id": 12,
"code": "whatsapp_user_not_found",
"message": "Ce numéro n'a pas de compte WhatsApp"
},
{
"id": 14,
"code": "bankily_number_not_allowed",
"message": "Ce numéro n'est pas autorisé a faire des transaction Bankily"
},
{
"id": 15,
"code": "bad_amount_50",
"message": "Le montant pour ce service doit êre un multiple de 50 MRU"
},
{
"id": 16,
"code": "bad_amount_100",
"message": "Le montant pour ce service doit êre un multiple de 100 MRU"
},
{
"id": 17,
"code": "bankily_operator_internal_error",
"message": "L'opérateur bankily a eu une erreur interne. veuillez ressayez "
},
{
"id": 18,
"code": "monthly_max_amount_cumul_reached",
"message": "Le bénéficiaire a atteint le montant maximum autorisé par mois."
},
{
"id": 19,
"code": "connexion_error",
"message": "Problème lors de la connexion au reseaux"
},
{
"id": 22,
"code": "monthly_max_amount_cumul_reached",
"message": "Le bénéficiaire a atteint le montant maximum autorisé par mois."
},
{
"id": 23,
"code": "no_bankily_account",
"message": "Le numero bankily est introuvable"
},
{
"id": 24,
"code": "interval_max_amount_cumul_reached",
"message": "Le bénéficiaire a atteint le montant maximum autorisé"
},
{
"id": 25,
"code": "interval_max_amount_cumul_reached",
"message": "Le bénéficiaire a atteint le montant maximum autorisé"
},
{
"id": 27,
"code": "monthly_max_amount_cumul_reached",
"message": "Le bénéficiaire a atteint le montant maximum autorisé par mois."
},
{
"id": 28,
"code": "operator_down_time",
"message": "L'opérateur est momentanément indisponible"
},
{
"id": 29,
"code": "execution_error",
"message": "Erreur lors de l'execution de la requete"
},
{
"id": 30,
"code": "invalid_phone_number",
"message": "no sedad account"
},
{
"id": 32,
"code": "execution_error",
"message": "Error transfering throught sedad"
},
{
"id": 33,
"code": "execution_error",
"message": "Erreur lors de l'execution de la requete"
},
{
"id": 34,
"code": "timeout_error",
"message": "délai d'attente dépassé lors de l'exécution de la requête"
},
{
"id": 35,
"code": "execution_error",
"message": "Erreur lors de l'execution de la requete"
},
{
"id": 36,
"code": "monthly_max_amount_cumul_reached",
"message": "Le bénéficiaire a atteint le montant maximum autorisé par mois."
},
{
"id": 38,
"code": "bad_amount_5",
"message": "Le montant pour ce service doit êre un multiple de 5 MRU"
},
{
"id": 39,
"code": "no_masrivi_account",
"message": "Le destinataire n'est pas un client Masrivi"
},
{
"id": 40,
"code": "monthly_max_amount_cumul_reached",
"message": "Le bénéficiaire a atteint le montant maximum autorisé par mois."
},
{
"id": 41,
"code": "interval_max_amount_cumul_reached",
"message": "Le bénéficiaire a atteint le montant maximum autorisé"
},
{
"id": 42,
"code": "monthly_max_amount_cumul_reached",
"message": "Le bénéficiaire a atteint le montant maximum autorisé par mois."
},
{
"id": 43,
"code": "pos_already_connected",
"message": "Problème lors de la connexion au reseaux"
},
{
"id": 44,
"code": "masrvi_invalid_amount",
"message": "Montant invalide. Il doit être supérieur à 1"
},
{
"id": 45,
"code": "an_error_occurred",
"message": "Une erreur est survenue veuillez essayer ultérieurement"
},
{
"id": 46,
"code": "invalid_state_change",
"message": "Changement de statut invalide"
},
{
"id": 47,
"code": "Mandatory_beneficiary_name",
"message": "Le nom du bénéficiaire est obligatoire"
},
{
"id": 48,
"code": "incorrect_masrvi_beneficiary_reference",
"message": "Référence du bénéficiaire incorrect"
},
{
"id": 49,
"code": "incorrect_requested_payment_date",
"message": "Date de paiement demandée incorrecte"
},
{
"id": 50,
"code": "refused_currency",
"message": "Devise refusée"
},
{
"id": 51,
"code": "masrvi_invalid_reference",
"message": "Référence invalide"
},
{
"id": 53,
"code": "client_not_authorized",
"message": "Le client n'est pas autorisé à effectuer cette opération"
},
{
"id": 54,
"code": "masrvi_client_ceiling_reached",
"message": "Plafond du client atteint"
},
{
"id": 55,
"code": "Reference_type_mismatch",
"message": "Le type de référence ou le référence du donneur d'ordre est incorrect"
},
{
"id": 56,
"code": "Mandatory_don_name",
"message": "Le nom du donneurOrdre est obligatoire"
},
{
"id": 57,
"code": "Reference_missing",
"message": "La référence du virement est invalide ou manquante."
}, {
"id": 59,
"code": "Service_not_found",
"message": "Le code de service est introuvable."
},
{
"id": 60,
"code": "Service_not_added",
"message": "you dont have this service yet"
}
]
}
Examples of error response
Status(403)
{"error":" The API key is missing or expired"}
Status(500)
{"error":"An error occurred. Please try again later "}