MB WAY via Adyen

Accept MB WAY payments from customers in Portugal with Adyen as the payment service provider (PSP). The customer enters their phone number at checkout and approves the payment in the MB WAY app. The customer stays on your checkout, with no redirect.

Supported workflows

Workflow	Supported
Payrails SDK	✔
Payrails API	✔
Delayed / Manual Capture	✖
Instant Capture	✔
Cancel / Void	✖
Refund / Reverse	✔
Save Instruments	✖
Merchant Initiated Transaction (MIT)	✖

Before you begin

Complete these steps before you send your first MB WAY payment through Adyen:

Set up an Adyen integration in your workspace. Follow the Adyen integration setup guide if you don’t have one yet.
Ask Adyen to enable MB WAY on your Adyen merchant account.
Configure Adyen webhook notifications for your integration. The payment completes only when Adyen sends the authorization result.
In the Payrails Portal, go to Settings → Integrations, open your Adyen integration, select MB WAY under Payment methods, and save.
Add MB WAY as a payment option in your workflow.

Request fields for Adyen

Send these fields in the authorize request, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to the PSP when you include them.

Field	Status	Description
`amount.currency`	Required	Must be `EUR`. Payrails rejects other currencies.
`paymentComposition[].paymentInstrumentData.payerFields.phoneCountryCode`	Required	The dialing code of the customer’s phone, digits only, for example `351`.
`paymentComposition[].paymentInstrumentData.payerFields.phoneNumber`	Required	The customer’s mobile number without the dialing code. Must be exactly nine digits.
`meta.customer.phone.number`, `meta.customer.phone.countryCode`	Optional	Used only when the payer fields carry no phone number. Payrails then requires `meta.customer.phone.number`.
`meta.customer.email`	Optional	Sent to Adyen as the shopper email.
`meta.customer.country.code`	Optional	Sent to Adyen as the country code, for example `PT`.

Authorize an MB WAY payment

Call authorize a payment with mbWay as the paymentMethodCode. Send the customer’s phone number as payer fields.

Authorize request

{
  "amount": {
    "value": "25.00",
    "currency": "EUR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "mbWay",
      "amount": {
        "value": "25.00",
        "currency": "EUR"
      },
      "paymentInstrumentData": {
        "payerFields": {
          "phoneCountryCode": "351",
          "phoneNumber": "912345678"
        }
      }
    }
  ],
  "meta": {
    "customer": {
      "email": "ines.costa@example.com",
      "country": {
        "code": "PT"
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

The response is pending and includes a wait action instead of a redirect. Show the customer a message that asks them to approve the payment in the MB WAY app. Then confirm the result through webhook notifications or the execution status before you fulfill the order.

How Adyen handles MB WAY

Payrails sends the phone number to Adyen in international format, for example +351912345678, and checks the payer fields before it calls Adyen.
The wait action gives the client a 15-minute window to poll for the result, which matches the Adyen MB WAY approval time.
Adyen captures MB WAY payments automatically. When Adyen confirms the authorization, Payrails also records the capture, so the payment completes in one step.
MB WAY through Adyen supports customer-initiated payments only. Payrails rejects an MIT, or a request with a stored PSP token, before it calls Adyen.
The Payrails SDK collects the phone number through payer fields when the amount is in EUR or isn’t known yet.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

Supported workflows

Before you begin

Request fields for Adyen

Authorize an MB WAY payment

How Adyen handles MB WAY

​Supported workflows

​Before you begin

​Request fields for Adyen

​Authorize an MB WAY payment

​How Adyen handles MB WAY

Supported workflows

Before you begin

Request fields for Adyen

Authorize an MB WAY payment

How Adyen handles MB WAY