---
title: "Initiate standing order from ASPSP"
method: POST
path: "/standing-order-initiations"
tags: ["Payment Initiations"]
---

# Initiate standing order from ASPSP

`POST /standing-order-initiations`

Initiate a new standing order to the specified destination account from an account held at an ASPSP.

## Request body

- PispgatewayCreateStandingOrderInitiationRequest — Request object to Initiate Standing Order
  - `aspspId` string, required — Identifier for ASPSP being used for the standing order
  - `payment` PispgatewayStandingOrderPayment, required — The payment of the standing order
    - `destination` PispgatewayDestination, required — The destination account for the payment
      - `type` 'ACCOUNT' | 'SCAN', required — Indicates the type of destination. Can be one of ACCOUNT, SCAN
      - `id` string — Identifier of the destination account if using ACCOUNT type
      - `accountNumber` string — Account Number of destination account if using SCAN type
      - `sortCode` string — Sort Code of destination account if using SCAN type
      - `name` string — Name of destination account if using SCAN type (this may be truncated)
    - `amount` PispgatewayStandingOrderPaymentAmount, required — The amount of the standing order
      - `currency` 'GBP', required — Currency of the account in ISO 4217 format. Default is GBP
      - `recurringAmount` number, required — Recurring amount of the payment in Major Currency Units - '1' = 1.00 GBP
    - `reference` string, 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.
  - `schedule` PispgatewayStandingOrderSchedule, required — The schedule of the standing order
    - `frequency` 'WEEKLY' | 'MONTHLY', required — Type of the capability, can be one of WEEKLY, MONTHLY
    - `initialDate` string, required — The date on which the standing order should begin. This must be at least 3 days in the future from today. Date format 'yyyy-MM-dd'
    - `finalDate` string — The optional date on which the standing order should end. If unspecified, the standing order will continue until cancelled.This must be at least 3 days in the future from today. Date format 'yyyy-MM-dd'
  - `context` PispgatewayPaymentContext, required — Payment context for the initiation request
    - `paymentContextCode` 'BILLPAYMENT' | 'ECOMMERCEGOODS' | 'ECOMMERCESERVICES' | 'OTHER' | 'PARTYTOPARTY' — Indicates type of Payment Context, can be one of BILLPAYMENT, ECOMMERCEGOODS, ECOMMERCESERVICES, OTHER, PARTYTOPARTY. If no value or paymentContext is provided, PARTYTOPARTY is considered the default value.
    - `deliveryAddress` PispgatewayDeliveryAddress — Information that locates and identifies a specific address, as defined by postal services or in free format text, must be specified if paymentContextCode is ECOMMERCEGOODS
      - `addressLine1` string, required — First line of the address
      - `addressLine2` string — Second line of the address
      - `postTown` string, required — The post town
      - `postCode` string, required — The postcode
      - `country` string, required — The country
    - `merchant` PispgatewayMerchantDetails, required — Merchant details for the payment context
      - `categoryCode` string — Merchant category code conform to ISO 18245, related to the type of services or goods provided for the transaction. Must be specified if paymentContextCode is either ECOMMERCEGOODS or ECOMMERCESERVICES
      - `customerId` string — Merchant customer identification, must be specified if paymentContextCode is either ECOMMERCEGOODS or ECOMMERCESERVICES

## Response `201`

Created

- PispgatewayCreateStandingOrderInitiationResponse — Response object to Initiate Standing Order
  - `standingOrderInitiationId` string — The unique identifier of the standing order initiation request at Modulr
  - `redirectUrl` string — A redirect URL for the user to authorise the standing order initiation request at the ASPSP

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/revisions/cbd52524c8ef/schema)