MB WAY is a digital solution created by SIBS to allow a simplified payment flow through your phone. According to SIBS, there are more than 3.4 million people using MB WAY right now and it is the biggest digital payment method in Portugal.

How it works

It works as an async payment method, which means: when you create a payment, we receive a response from SIBS that the payment was created and we should wait for the customer to pay. So, differently from other methods, our transaction stays with a processing status. As soon as the customer does the payment, SIBS system notifies of the execution of the transaction, and the payment is updated to success or failed.

Create payment

You can see below the simplest example of how to create an MB WAY payment and the generated response:

curl --request POST \
  --url https://gateway.paybyrd.com/api/v2/payment \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: 5E37D19C-F99C-445F-8B77-1463EFC66C7B' \
  --data '
{  
    "type":"OnlineTransfer",
    "amount": "10.00",
    "currency": "EUR",
    "brand":"MBWay",
    "phoneNumber": "969770085",
    "phoneCountryCode": "351"
}'
{
    "phoneCountryCode": "351",
    "phoneNumber": "969770085",
    "type": "OnlineTransfer",
    "currency": "EUR",
    "brand": "MBWay",
    "code": "BYRD201",
    "description": "Payment being processed. Waiting for shopper",
    "transactionId": "9898cb76-45fa-407f-b205-a019a917d0e7",
    "amount": "10.00"
}

See the full API reference here.

In order to know whether the transaction was accepted or not, you must check the code field. For successful scenarios, the expected code is BYRD201. You can find here the list of all possible codes