---
title: "Pay Multiple"
method: POST
path: "/za/pb/v1/accounts/{accountId}/paymultiple"
tags: ["Beneficiaries and Beneficiary payments"]
---

# Pay Multiple

`POST /za/pb/v1/accounts/{accountId}/paymultiple`

## Request

- Base URL: `https://openapi.investec.com`
- URL: `https://openapi.investec.com/za/pb/v1/accounts/{accountId}/paymultiple`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://openapi.investec.com/identity/v2/oauth2/token` scopes: `beneficiarypayments`

Pay funds to one or multiple beneficiaries. 

- Size limit of 50 payments per request.

## Path parameters

- `accountId` string, required

## Headers

- `Content-Type` string, required

## Request body

- object
  - `paymentList` object[]
    - `beneficiaryId` string, required
    - `amount` string, required
    - `myReference` string, required
    - `theirReference` string, required
    - `authoriserAId` string: If the payment requires authorisation this is derived from profiles/{profileid}/accounts/{accountId}/authorisationsetupdetails.
    - `authoriserBId` string: If the payment requires authorisation this is derived from profiles/{profileid}/accounts/{accountId}/authorisationsetupdetails.
    - `authPeriodId` string: If the payment requires authorisation this is derived from profiles/{profileid}/accounts/{accountId}/authorisationsetupdetails.
    - `fasterPayment` boolean: If the payment requires authorisation this can be set to true if the beneficiary allows it from profiles/{profileid}/beneficiaries/{accountid}.

## Response `200`

Resource has been retrieved

- object
  - `data` object, required: Set of elements used to define the transfer status details.
    - `TransferResponses` object[]
      - `PaymentReferenceNumber` string: Internal transfer reference number
      - `PaymentDate` string: Transfer date
      - `Status` string: Transfer outcome status
      - `BeneficiaryName` string: Transfer reference used
      - `BeneficiaryAccountId` string: Account ID of the destination account
      - `AuthorisationRequired` boolean: Boolean value describing if authorisation is required
    - `ErrorMessage` string, nullable
  - `meta` object, required: Meta Data relevant to the payload
    - `totalPages` integer
  - `links` object, required: Links relevant to the payload
    - `self` string, required

## Other responses

- `400`: Bad Request - The requested operation will not be carried out
- `401`: Unauthorized - The requested operation was refused access
- `403`: Forbidden - Not permitted to make this request
- `429`: Too Many Requests - To many requests in quick succession, Retry the request.
- `500`: Internal Server Error - The requested operation failed to execute

---

[API](https://skmtc.dev/rijnhardtkotze/apis/sa-pb-account-information.md) - [All operations](https://skmtc.dev/rijnhardtkotze/apis/sa-pb-account-information/llms.txt) - [OpenAPI document](https://skmtc.dev/rijnhardtkotze/apis/sa-pb-account-information/revisions/1ab926851d29?raw)
