MB WAY via Adyen

​

Supported workflows

​

Before you begin

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

​

Request fields for Adyen

​

Authorize an MB WAY payment

{
  "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"
  }
}

​

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.