---
title: "Initiate a variable recurring payment"
method: POST
path: "/open-banking/vrps"
tags: ["Variable Recurring Payments"]
---

# Initiate a variable recurring payment

`POST /open-banking/vrps`

Allows the initiation of a variable recurring payment against a mandate.

## Headers

- `Company-Id` string, uuid
- `Mid` string, uuid

## Request body

- OpenBankingVrpCreateRequest
  - `payment` object, required
    - `mandate_id` string, required — The unique ID of the mandate to take the payment against.
  - `transaction` object, required
    - `order_id` string, required — Unique reference assigned by you for the payment request.
    - `amount` number, required — The amount to be taken from the debtor account on the mandate.
    - `currency` string, required — ISO 4217 currency code. Case-insensitive.
    - `custom1` string — Send additional data relating to the customer or another internal reference.
    - `custom2` string — Send additional data relating to the customer or another internal reference.
  - `webhook_url` string, uri, required — The URL to which webhook notifications should be sent for updates on the payment status.

## Response `200`

OK

- OpenBankingVrp
  - `vrp_id` string — Unique identifier assigned by Acquired.com for the VRP.
  - `transaction_id` string, uuid — Unique identifier assigned by Acquired.com for the transaction (if applicable).
  - `status` string — VRP status.
  - `reason` string — Decline reason (when applicable). Possible values include `insufficient_funds` and `periodic_limit_reached`.
  - `end_to_end_identification` string — End-to-end identification for the payment.
  - `links` object[]
    - `rel` string
    - `href` string

## Other responses

- `400`
- `401`
- `403`
- `500`

---

[API](https://skmtc.dev/acquired/apis/acquired-api.md) · [All operations](https://skmtc.dev/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/acquired/acquired-api/revisions/7ae178a046f2/schema)