YAyapily
Authorisations

Create Payment Pre-authorisation

Used to initiate the pre-authorisation process for payments for CBI Globe institutions that contain the INITIATE_ONETIME_PRE_AUTHORISATION_PAYMENTS feature to authenticate the user.

Feature: INITIATE_ONETIME_PRE_AUTHORISATION_PAYMENTS

post/payment-pre-auth-requests

Request

  • Base URL
    https://api.yapily.com
  • Auth
    HTTP basic

Query parameters

rawboolean

Optional. Used to obtain the raw request and response to and from the Institution.

Headers

psu-ip-addressstring

Conditional. The IP address of the PSU.

See PSU identifiers to see if this header is required.

sub-applicationstring uuid

The sub-application ID to which event type is being subscribed to

Request body

userUuidstring uuid
applicationUserIdstring

Conditional. The user-friendly reference to the User that will authorise the authorisation request. If a User with the specified applicationUserId exists, it will be used otherwise, a new User with the specified applicationUserId will be created and used. Either the userUuid or applicationUserId must be provided.

forwardParametersstring[]

Extra parameters to be forwarded in the redirect back to the client after the user authorisation flow has been completed.

institutionIdstring required

Mandatory. The reference to the Institution which identifies which institution the authorisation request is sent to.

callbackstring

Optional. The server to redirect the user to after the user complete the authorisation at the Institution.

See Using a callback (Optional) for more information.

oneTimeTokenboolean

Conditional. Used to receive a oneTimeToken rather than a consentToken at the callback for additional security. This can only be used when the callback is set.

See Using a callback with an OTT (Optional) for more information.

scopestring required

Mandatory. Defines the scope of the pre-authorisation request.

referencestring required

Mandatory. The payment reference or description. Limited to a maximum of 18 characters long.

Example request

{
  "applicationUserId": "user-234562290",
  "institutionId": "yapily-mock",
  "callback": "https://display-parameters.com",
  "scope": "AIS",
  "payee": {
    "name": "Jane Doe",
    "accountIdentifications": [
      {
        "identification": "IBUK123456789",
        "type": "IBAN"
      }
    ],
    "country": "GB",
    "address": {
      "country": "GB"
    }
  },
  "payer": {
    "accountIdentifications": [
      {
        "type": "SORT_CODE",
        "identification": "401016"
      }
    ]
  },
  "amount": {
    "amount": 10,
    "currency": "GBP"
  },
  "reference": "Bill payment"
}

Response

Created

linksobject
tracingIdstring

Changes

No recorded changes to this operation across all 4 revisions of this API.