---
title: "Authorize"
method: POST
path: "/v1.02/mbway/authorize"
---

# Authorize

`POST /v1.02/mbway/authorize`

## Request

- Base URL: `https://sandbox.eupago.pt/api/auth`
- URL: `https://sandbox.eupago.pt/api/auth/v1.02/mbway/authorize`
- Auth: none required
- TypeScript: <https://skmtc.dev/eupago/apis/intro-and-oauth/docs/v1.02/mbway/authorize/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates MB WAY authorization. (The customer have 5 minutes to execute the payment after receiving the payment notification via MBWAY app.)

## Request body

- object
  - `payment` object, required: Informations regarding the payment
    - `identifier` string
    - `amount` object
      - `value` number, float, required: Payment amount
      - `currency` string, required
    - `customerPhone` string, required: Phone number that is connected to the MB WAY app and will accept the payment
    - `countryCode` string, required: Respective country code from the customer phone (+351 for portuguese number)

## Response `201`

201

- object
  - `transactionStatus` string
  - `transactionID` string
  - `reference` string

## Other responses

- `401`: 401

---

[API](https://skmtc.dev/eupago/apis/intro-and-oauth.md) - [All operations](https://skmtc.dev/eupago/apis/intro-and-oauth/llms.txt) - [OpenAPI document](https://skmtc.dev/eupago/apis/intro-and-oauth/revisions/778475fa98e9?raw)