MB Way is an alternative payment method exclusive to Portugal that we offer through SIBS, which allows you to make payments using a cell phone number.

Using this payment method, the user will receive a PUSH notification on his cell phone that will allow him to make the payment through his bank's application. There are two ways to integrate it: by redirection or push payment.

Integration by redirection

To integrate by redirection, the user must be present at the time of payment, which must be processed through a browser. First we must generate a payment order optionally indicating the user's phone number so that the user does not have to fill it in.

  "extra_data": {
    "profile": {
      "first_name": "Carlos",
      "last_name": "Moreno"
      "phone": {
        "number": "655655655",
        "prefix": "351"
      }
    }
  }

As service identifier, the service_uuid of SIBS service you have activated in your Paylands Backend → Manage → Payment Services → Listing must be indicated.

Once the order is generated, the user must be redirected to the payment screen indicating the token of the order and in the query, the name of the APM:

We construct the redirection URL by replacing the token of the order returned from the previous call.

https://api.paylands.com/v1/sandbox/payment/process/{token}?apm=MBWAY

Once the user is redirected to this screen, they will receive the notification on their cell phone. When they completes the payment, they will be redirected back to the OK or KO URL, depending on the result of the payment.

Push payment integration

If on the other hand we do not want to require the user to be present at the time of payment, this payment method can be integrated via push payment.

To do this, we must first generate a payment order Mandatory with the user's first name, last name and telephone number. If you do not have the user's name and surname, you can send an empty string in these fields.

  "extra_data": {
    "profile": {
      "first_name": "Carlos",
      "last_name": "Moreno"
      "phone": {
        "number": "655655655",
        "prefix": "351"
      }
    }
  }

Next, the push payment request must be launched indicating the UUID of the order. Then the user will receive the push notification on his cell phone, and once he completes the payment, the merchant will receive the payment notification to the URL indicated in the field `url_postundefined when generating the payment order.

Testing

For more information on how to test this payment method on each of your vendors, visit the SIBS documentation.