Payment transaction workflow

After successful integration to your website, the following workflow occurs for a payment transaction

A customer creates an order in your online shop and clicks on checkout. This triggers E-nkap's POST /api/order endpoint to create an order with.
The customer will now choose the payment option that is best for him and submit. Just MTN Mobile Money, Smobilpay, Express Union Mobile and Orange Money are supported for now.

Based on the payment service provider, a feedback request may be necessary to confirm the transaction on the customer's side (e.g. MTN cashout confirmation via SMS or USSD).
Once the payment has been made, the status of the transaction will be changed to
1. CONFIRMED in case of success or
2. FAILED in case the payment was unsuccessful
The status of the order can at any time be obtained by calling the endpoint GET /api/order/status.
If a notification URL is set in the merchant's API settings, changes in the transaction status will be sent to this URL.

Payment workflow

Payment Flow with each payment provider


MTN Mobile Money	When the order has been created and has the status CREATED and the customer selects MTN Mobile Money as the method of payment; The customer enters a name, mobile money number, email, confirms terms and conditions and clicks on submit; The status of the transaction changes to IN_PROGRESS. The customer receives a USSD approval request from MTN to approve the payment of the order. Customer approves the payment request by entering his secret code and submitting. The customer's account is debited by the order amount if the transaction is successful. If the transaction is successful, the status of the transaction changes PENDING to CONFIRMED else FAILED. Customer is notified by MTN if the transaction is successful.
Express Union Mobile	When the order has been created and has the status CREATED and the customer selects Express Union Mobile Money as the method of payment; The customer enters a name, EU mobile number, email, confirms terms and conditions and clicks on submit. The status of the transaction changes to IN_PROGRESS. The customer receives an SMS notification to approve the payment of the order on the EU mobile app. Customer approves the payment request by entering his secret code and submitting. The customer's account is debited by the order amount if the transaction is successful. If the transaction is successful, the status of the transaction changes from PENDING to CONFIRMED or FAILED. Customer is notified by Express Union if the transaction is successful.
Orange Money	When the order has been created and has the status CREATED and the customer selects Orange Mobile Money as the method of payment; The customer enters a name, mobile money number, email, confirms terms and conditions and clicks on submit; The status of the transaction changes to IN_PROGRESS. The customer receives a USSD approval request from Orange to approve the payment of the order. Customer approves the payment request by entering his secret code and submitting. The customer's account is debited by the order amount if the transaction is successful. If the transaction is successful, the status of the transaction changes PENDING to CONFIRMED else FAILED. Customer is notified by Orange if the transaction is successful.
YooMee Money	When the order has been created and has the status CREATED and the customer selects YooMee Money as the method of payment; The customer enters a name, YooMee mobile number, email, confirms terms and conditions and clicks on submit. The status of the transaction changes to IN_PROGRESS. The customer receives an SMS notification to approve the payment of the order on the YooMee mobile app. Customer approves the payment request by entering his secret code and submitting. The customer's account is debited by the order amount if the transaction is successful. If the transaction is successful, the status of the transaction changes from PENDING to CONFIRMED or FAILED. Customer is notified by YooMee if the transaction is successful.