API
Saltar al contenido principal

Pago con MB WAY utilizando el número de teléfono móvil

Para iniciar un pago a través de MB WAY únicamente se necesita el número de teléfono móvil asociado a la cuenta de MB WAY.

El proceso funciona como sigue:

  1. Envío de la notificación de pago a la aplicación MB WAY (la notificación expira después de 5-10 minutos);
  2. El usuario confirma el pago en la aplicación;
  3. Consulta del estado del pago (opcional si tiene una suscripción a un webhook).

El siguiente flujo ilustra el funcionamiento del pago por MB WAY:

MB WAY flow

1. Envío de la notificación de pago MB WAY​

POST /payments​

{
	"type": "payment",
	"amount": 100,
	"callbackUrl": "https://teste.pt", // Opcional se usar webhooks
	"paymentMethod": {
		"code": "MW",
		"details": {
			"phoneNumber": "351#123456789"
		}
	}
}

2. El usuario valida el pago en la aplicación MB WAY​

MB WAY confirmed

3. Consulta del estado del pago​

GET ​/payments/{id} ​

{
	"apiVersion": "1.0",
	"date": "2021-10-18T11:45:12+01:00",
	"success": true,
	"data": {
		"id": "42373",
		"referenceDetails": {
			"reference": "A0000A585"
		},
		"stateDetails": {
			"state": "confirmed",
			"createdAt": "2021-10-07T18:07:46+01:00"
		},
		"paymentMethod": {
			"code": "MW",
			"type": "DEFAULT",
			"details": {
				"countryCode": "351",
				"last3Digits": "263"
			}
		},
		"amount": 100,
		"createdAt": "2021-10-07T18:06:46+01:00",
		"updatedAt": "2021-10-07T18:06:46+01:00",
		"validDate": {
			"start": "2021-10-07T18:06:46+01:00",
			"end": "2021-10-07T18:36:46+01:00"
		},
		"availableMethods": [
			{
				"code": "MW",
				"type": "DEFAULT",
				"name": "MB WAY"
			}
		],
		"paymentFee": {
			"netAmount": "0.27750000",
			"taxAmount": "0.04995000",
			"invoiceDetails": null
		}
	}
}