Skip to main content

MBWAY

Craftgate is integrated with MB WAY as an alternative payment method. You can accept payments via MB WAY through the Common Payment Page or directly via API.

Things to do first​

In order to use the MB WAY integration, you must have completed the following steps.

  1. Alternative Payment Methods must be On on Merchant Panel > Administration > Merchant Settings > Craftgate Features list.

    Alternative Payment Methods in Craftgate Features

  2. Enter the information sent to you by MB WAY on Merchant Panel > Administration > APM Management > MB WAY after Enable MB WAY Integration status.

    MB WAY integration settings

Payment Flow with MB WAY​

You can receive payments from MB WAY users either via the Common Payment Page form or the API.

Payment via MB WAY from API​

To receive payments through MB WAY via API, you can use the alternative payment method service. The MB WAY payment flow consists of two steps. You need to send the following parameters in additionParams to the APM Payment Start endpoint.

note

To receive payments with MB WAY, the apmType field should be "PAYLANDS_MB_WAY".

additionalParams

1. APM Payment Start: You need to send apmType as PAYLANDS_MB_WAY and the recipient’s details under additionalParams to the APM Payment Start endpoint.

For more details, see Payment via Alternative Payment Method.

In the response to the APM Payment Start request, the additionalAction field should return WAIT_FOR_WEBHOOK, and the user should receive a notification from MB WAY during this process. Then, the payment process should continue on the mobile application.

2. APM Payment Completion: The APM Payment Completion step is completed by the user through the mobile application. The payment is completed by Craftgate, which regularly checks the payment status through MB WAY. It is essential for the merchant to listen for webhook notifications to stay informed about the payment status.

For more details, see Webhook Notifications.

Payments via Common Payment Page​

After entering the MB WAY details in the Merchant Dashboard, the MB WAY tab will appear on the Payment Form when the Common Payment Page is started. See Receiving Payments via Common Payment Page.

Here is a summary of the payment experience and flow:

  1. When the MB WAY tab is clicked, a message will appear informing the user get notification from MB WAY to mobile phone.

    MB WAY Common Payment Page Tab

  2. After pressing the Pay button, the user must confirm the payment through the mobile app. Craftgate will regularly check the payment status through MB WAY until it is completed. It is essential for the merchant to listen for webhook notifications to stay informed about the payment status.

Sample Code for APM Payment Start​

Java.NETPHPNode.jsGo