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

# Initiate payment from ASPSP

`POST /payment-initiations`

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

## Request body

- PispgatewayCreatePaymentInitiationRequest — Request object to Initiate Payment
  - `paymentAmount` PispgatewayPaymentAmount, required — The amount of the payment
    - `currency` 'GBP', required — Currency of the account in ISO 4217 format. Only allowable value is GBP
    - `value` number, required — Amount of the payment in Major Currency Units - '1' = 1.00 GBP
  - `paymentReference` 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.
  - `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)
  - `aspspId` string, required — Identifier for ASPSP being used for the payment
  - `paymentContext` PispgatewayLegacyPaymentContext — 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
    - `merchantCategoryCode` 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
    - `merchantCustomerIdentification` string — Merchant customer identification, must be specified if paymentContextCode is either ECOMMERCEGOODS or ECOMMERCESERVICES

## Response `201`

Created

- PispgatewayCreatePaymentInitiationResponse — Response object to Initiate Payment
  - `paymentInitiationId` string — The unique identifier of the payment initiation request at Modulr
  - `redirectUrl` string — A redirect URL for the user to authorise the payment 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)