Sign in

v1

latestOpenAPI 3.1.0© Modulr Finance2026-08-04207430590.4 KB
Payment Initiations

Initiate payment from ASPSP

Initiate a payment to the specified destination account from an account held at an ASPSP.

post/payment-initiations

Request body

paymentReferencestring required

Reference to be used for the Payment. This will appear on the Account statement/the recipient's bank account. Min 6 to max 18 characters. Can contain alphanumeric, '-', '.', '&', '/' and space.

aspspIdstring required

Identifier for ASPSP being used for the payment

Example request

{
  "paymentReference": "Invoice ABC123",
  "destination": {
    "id": "A1100001",
    "accountNumber": "12345678",
    "sortCode": "000000",
    "name": "Test"
  },
  "aspspId": "H100000001"
}

Response

Created

paymentInitiationIdstring

The unique identifier of the payment initiation request at Modulr

redirectUrlstring

A redirect URL for the user to authorise the payment initiation request at the ASPSP

Example response

{
  "paymentInitiationId": "I000000001",
  "redirectUrl": "https://www.bankofmoney.com/authorize"
}