APP_NOTIFICATION

Consumers receive a push notification from their banking or payment app prompting them to log in and approve the payment. Once the payment is authorized, the provider communicates the result back to PPRO. This process is commonly referred to as the Desktop-to-Mobile flow, as it typically begins on a desktop device and is then "handed off" to the consumer’s mobile device through an app-based push notification.

APP_NOTIFICATION authentication does not require any additional authenticationSettings.

Request

//...
  "authenticationSettings": [
    {
      "type": "APP_NOTIFICATION"
    }
  ]
//...

Response

//...
  "authenticationMethods": [
    {
      "details": {},
      "type": "APP_NOTIFICATION"
    }
  ]
//...

To proceed with the APP_NOTIFICATION authentication flow requires you to provide an instrumentProviderIdentity, such as an email address or phone number, that the provider uses to identify the consumer and trigger the push notification.

Request

POST /v1/payment-charges/{paymentChargeId}/authorizations

{
  "authenticationResult": {
    "type": "APP_NOTIFICATION",
    "details": {
      "instrumentProviderIdentity": "+34700000000"
    }
  }
}

Response

{
    "id": "authz_T2nP3ZL6bH6tscyJL7ymv",
    "amount": 1000,
    "status": "AUTHENTICATION_PENDING",
    "merchantPaymentChargeReference": "YOUR_ORDER_NUMBER",
    "createdAt": "2025-04-28T16:42:36.316Z",
    "updatedAt": "2025-04-28T16:42:51.251Z",
    "_links": {
        "payment_charge": {
            "href": "/v1/payment-charges/charge_rpxa3BpKcPzUlhYVKyvAV"
        }
    }
}