--- title: Amend Payment Schedule Status slug: r10-integration/amend-payment-schedule-status createdAt: 2026-10-29T06:44:31.903Z --- { "id": "HeWZ68pg0zf_2182ohzY4", "type": "api-oas-v2", "data": { "method": "PATCH", "url": "https://api-beta.monoova.com/au/payto/pam-v1/PaymentSchedule/{scheduleId}/status", "servers": [ { "url": "https://api-beta.monoova.com/au/payto/pam-v1/PaymentSchedule/{scheduleId}/status", "description": "Beta Sandbox URL" } ], "name": "Amend Payment Schedule Status", "description": "Amend an existing payment schedule status.", "contentType": "application/json", "request": { "pathParameters": [ { "kind": "required", "name": "scheduleId", "type": "string", "example": "MONSCH12345", "description": "

ID that uniquely identifies the payment schedule. This is the scheduleId supplied when the schedule was created.

", "default": "MONSCH12345", "pattern": "^[a-zA-Z0-9_-]{1,36}$" } ], "headerParameters": [ { "name": "accept", "type": "string", "kind": "optional", "description": "Generated from available response content types", "enum": [ "application/json" ], "default": "application/json" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "required", "name": "body", "type": "object", "description": "Status change to apply to a payment schedule.", "customType": "MandateManager.Application.PaymentSchedules.Dto.AmendPaymentScheduleStatusDtoIn", "schema": [ { "name": "status", "kind": "required", "type": "string", "description": "

Status to which the schedule will be changed. Accepted values: Active, Paused, Cancelled.

", "example": "Paused", "default": "Paused", "pattern": "^(Active|Paused|Cancelled)$" }, { "name": "statusReasonDescription", "kind": "optional", "type": "string", "nullable": true, "description": "

Optional. Reason for the status change, up to 256 characters.

", "example": "Customer requested a pause in payments", "default": "Customer requested a pause in payments", "maxLength": 256, "pattern": "^[ -~]{0,256}$" } ], "modelRef": "#/components/schemas/MandateManager.Application.PaymentSchedules.Dto.AmendPaymentScheduleStatusDtoIn", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "BearerAuth", "name": "BearerAuth", "kind": "optional", "type": "http", "description": "

Bearer token (JWT) used to authenticate PayTo API requests. Generate it with the Monoova security token endpoint (/au/security/oauth-v1/Token) using your mAccount number and API key, then send it in the Authorization: Bearer <token> header. Tokens are valid for 24 hours.

", "scheme": "bearer" } ], "cookieParameters": [] }, "responses": [ { "statusCode": "200", "description": "OK. The payment schedule status was changed.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "description": "Result of a payment schedule status change.", "customType": "MandateManager.Application.PaymentSchedules.Dto.AmendPaymentScheduleStatusResponse", "schema": [ { "name": "traceId", "kind": "optional", "type": "string", "nullable": true, "description": "Unique ID for logging and tracing this request.", "example": "1dabfaa9-abe8-4d2d-a69a-b723079d84ed", "default": "1dabfaa9-abe8-4d2d-a69a-b723079d84ed", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, { "name": "scheduleId", "kind": "optional", "type": "string", "nullable": true, "description": "ID that uniquely identifies the payment schedule.", "example": "MONSCH12345", "default": "MONSCH12345", "pattern": "^[a-zA-Z0-9_-]{1,36}$" }, { "name": "status", "kind": "optional", "type": "string", "nullable": true, "description": "

Status of the schedule. Possible values: Pending, Active, Paused, Cancelled.

", "example": "Paused", "default": "Paused", "pattern": "^(Pending|Active|Paused|Cancelled)$" }, { "name": "statusDescription", "kind": "optional", "type": "string", "nullable": true, "description": "Description of the status.", "example": "Paused", "default": "Paused", "pattern": "^.+$" }, { "name": "statusReasonCode", "kind": "optional", "type": "string", "nullable": true, "description": "

Reason code for the status. Possible values: CustReq, CreateError, Expired, AgreementStatusChanged, InvalidPayeeDetails, BilateralAmendmentInitiated, MaxedOutTotalInstanceLimit, MaxedOutTotalAmountLimit, ExceededScheduleEndDate, FinalPaymentInitiated, SchedulingDisabled.

", "example": "CustReq", "default": "CustReq", "pattern": "^(CustReq|CreateError|Expired|AgreementStatusChanged|InvalidPayeeDetails|BilateralAmendmentInitiated|MaxedOutTotalInstanceLimit|MaxedOutTotalAmountLimit|ExceededScheduleEndDate|FinalPaymentInitiated|SchedulingDisabled)$" }, { "name": "statusReasonDescription", "kind": "optional", "type": "string", "nullable": true, "description": "Description of the reason code.", "example": "Customer requested a pause in payments", "default": "Customer requested a pause in payments", "pattern": "^.+$" } ], "modelRef": "#/components/schemas/MandateManager.Application.PaymentSchedules.Dto.AmendPaymentScheduleStatusResponse", "isExpanded": true } ] }, { "statusCode": "400", "description": "

Bad Request. The request failed validation. See errors for details.

", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "example": "{\"traceId\":\"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\"errors\":[{\"errorCode\":\"PAM_SCHED_STATUS_UPDATE_NOCHANGE\",\"errorMessage\":\"Payment schedule MONSCH12345 is already Paused\"}]}", "description": "Error response returned when a request fails.", "customType": "MandateManager.Application.Common.Dtos.ErrorResponse", "schema": [ { "name": "traceId", "kind": "optional", "type": "string", "nullable": true, "description": "Unique ID for logging and tracing this request.", "example": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "default": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, { "name": "errors", "kind": "optional", "type": "array", "nullable": true, "description": "List of errors that occurred while processing the request.", "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorDto", "customType": "MandateManager.Application.Common.Dtos.ErrorDto[]", "schema": [ { "name": "errorCode", "kind": "optional", "type": "string", "nullable": true, "description": "

Monoova error code. See PayTo Status and Error Codes for the meaning of each code.

", "example": "PAM_STARTDATE_EARLY", "default": "PAM_STARTDATE_EARLY", "pattern": "^[A-Z]{3}_[A-Z0-9_]+$" }, { "name": "errorMessage", "kind": "optional", "type": "string", "nullable": true, "description": "

More detailed description of the error, which may include information from the request.

", "example": "paymentDetails.startDate must be future date", "default": "paymentDetails.startDate must be future date", "pattern": "^.+$" } ] } ], "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorResponse", "isExpanded": true } ] }, { "statusCode": "401", "description": "

Unauthorized. The bearer token is missing, invalid or expired. Bearer tokens are valid for 24 hours; generate a new token and retry.

", "jsonExample": "", "isExpanded": true }, { "statusCode": "403", "description": "Forbidden. Your account is not permitted to perform this operation.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "example": "{\"traceId\":\"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\"errors\":[{\"errorCode\":\"PAM_FORBIDDEN_ERROR\",\"errorMessage\":\"Not allowed to amend payment schedule status for account 6279059778044302\"}]}", "description": "Error response returned when a request fails.", "customType": "MandateManager.Application.Common.Dtos.ErrorResponse", "schema": [ { "name": "traceId", "kind": "optional", "type": "string", "nullable": true, "description": "Unique ID for logging and tracing this request.", "example": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "default": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, { "name": "errors", "kind": "optional", "type": "array", "nullable": true, "description": "List of errors that occurred while processing the request.", "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorDto", "customType": "MandateManager.Application.Common.Dtos.ErrorDto[]", "schema": [ { "name": "errorCode", "kind": "optional", "type": "string", "nullable": true, "description": "

Monoova error code. See PayTo Status and Error Codes for the meaning of each code.

", "example": "PAM_STARTDATE_EARLY", "default": "PAM_STARTDATE_EARLY", "pattern": "^[A-Z]{3}_[A-Z0-9_]+$" }, { "name": "errorMessage", "kind": "optional", "type": "string", "nullable": true, "description": "

More detailed description of the error, which may include information from the request.

", "example": "paymentDetails.startDate must be future date", "default": "paymentDetails.startDate must be future date", "pattern": "^.+$" } ] } ], "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorResponse", "isExpanded": true } ] }, { "statusCode": "404", "description": "Not Found. The payment schedule could not be found.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "example": "{\"traceId\":\"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\"errors\":[{\"errorCode\":\"PAM_SCHED_NOT_FOUND_ERROR\",\"errorMessage\":\"PaymentSchedule not found for ScheduleId MONSCH12345\"}]}", "description": "Error response returned when a request fails.", "customType": "MandateManager.Application.Common.Dtos.ErrorResponse", "schema": [ { "name": "traceId", "kind": "optional", "type": "string", "nullable": true, "description": "Unique ID for logging and tracing this request.", "example": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "default": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, { "name": "errors", "kind": "optional", "type": "array", "nullable": true, "description": "List of errors that occurred while processing the request.", "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorDto", "customType": "MandateManager.Application.Common.Dtos.ErrorDto[]", "schema": [ { "name": "errorCode", "kind": "optional", "type": "string", "nullable": true, "description": "

Monoova error code. See PayTo Status and Error Codes for the meaning of each code.

", "example": "PAM_STARTDATE_EARLY", "default": "PAM_STARTDATE_EARLY", "pattern": "^[A-Z]{3}_[A-Z0-9_]+$" }, { "name": "errorMessage", "kind": "optional", "type": "string", "nullable": true, "description": "

More detailed description of the error, which may include information from the request.

", "example": "paymentDetails.startDate must be future date", "default": "paymentDetails.startDate must be future date", "pattern": "^.+$" } ] } ], "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorResponse", "isExpanded": true } ] }, { "statusCode": "500", "description": "Internal Server Error. An unexpected error occurred. Contact Monoova support if the problem persists.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "example": "{\"traceId\":\"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\"errors\":[{\"errorCode\":\"PAM_UNEXPECTED_ERROR\",\"errorMessage\":\"Internal server error. Please contact Monoova support.\"}]}", "description": "Error response returned when a request fails.", "customType": "MandateManager.Application.Common.Dtos.ErrorResponse", "schema": [ { "name": "traceId", "kind": "optional", "type": "string", "nullable": true, "description": "Unique ID for logging and tracing this request.", "example": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "default": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, { "name": "errors", "kind": "optional", "type": "array", "nullable": true, "description": "List of errors that occurred while processing the request.", "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorDto", "customType": "MandateManager.Application.Common.Dtos.ErrorDto[]", "schema": [ { "name": "errorCode", "kind": "optional", "type": "string", "nullable": true, "description": "

Monoova error code. See PayTo Status and Error Codes for the meaning of each code.

", "example": "PAM_STARTDATE_EARLY", "default": "PAM_STARTDATE_EARLY", "pattern": "^[A-Z]{3}_[A-Z0-9_]+$" }, { "name": "errorMessage", "kind": "optional", "type": "string", "nullable": true, "description": "

More detailed description of the error, which may include information from the request.

", "example": "paymentDetails.startDate must be future date", "default": "paymentDetails.startDate must be future date", "pattern": "^.+$" } ] } ], "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorResponse", "isExpanded": true } ] }, { "statusCode": "502", "description": "

Bad Gateway. An upstream service, such as the NPP gateway, returned an error. Retry the request later.

", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "example": "{\"traceId\":\"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\"errors\":[{\"errorCode\":\"PAM_SCHEDULER_ERROR\",\"errorMessage\":\"Error returned from scheduler service - service unavailable\"}]}", "description": "Error response returned when a request fails.", "customType": "MandateManager.Application.Common.Dtos.ErrorResponse", "schema": [ { "name": "traceId", "kind": "optional", "type": "string", "nullable": true, "description": "Unique ID for logging and tracing this request.", "example": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "default": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, { "name": "errors", "kind": "optional", "type": "array", "nullable": true, "description": "List of errors that occurred while processing the request.", "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorDto", "customType": "MandateManager.Application.Common.Dtos.ErrorDto[]", "schema": [ { "name": "errorCode", "kind": "optional", "type": "string", "nullable": true, "description": "

Monoova error code. See PayTo Status and Error Codes for the meaning of each code.

", "example": "PAM_STARTDATE_EARLY", "default": "PAM_STARTDATE_EARLY", "pattern": "^[A-Z]{3}_[A-Z0-9_]+$" }, { "name": "errorMessage", "kind": "optional", "type": "string", "nullable": true, "description": "

More detailed description of the error, which may include information from the request.

", "example": "paymentDetails.startDate must be future date", "default": "paymentDetails.startDate must be future date", "pattern": "^.+$" } ] } ], "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorResponse", "isExpanded": true } ] }, { "statusCode": "503", "description": "Service Unavailable. The service is temporarily unavailable. Retry the request later.", "jsonExample": "", "isExpanded": true }, { "statusCode": "504", "description": "

Gateway Timeout. An upstream service, such as the NPP gateway, did not respond in time. Retry the request later.

", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "example": "{\"traceId\":\"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\"errors\":[{\"errorCode\":\"PAM_SCHEDULER_TIMEOUT\",\"errorMessage\":\"Timeout from scheduler service\"}]}", "description": "Error response returned when a request fails.", "customType": "MandateManager.Application.Common.Dtos.ErrorResponse", "schema": [ { "name": "traceId", "kind": "optional", "type": "string", "nullable": true, "description": "Unique ID for logging and tracing this request.", "example": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "default": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, { "name": "errors", "kind": "optional", "type": "array", "nullable": true, "description": "List of errors that occurred while processing the request.", "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorDto", "customType": "MandateManager.Application.Common.Dtos.ErrorDto[]", "schema": [ { "name": "errorCode", "kind": "optional", "type": "string", "nullable": true, "description": "

Monoova error code. See PayTo Status and Error Codes for the meaning of each code.

", "example": "PAM_STARTDATE_EARLY", "default": "PAM_STARTDATE_EARLY", "pattern": "^[A-Z]{3}_[A-Z0-9_]+$" }, { "name": "errorMessage", "kind": "optional", "type": "string", "nullable": true, "description": "

More detailed description of the error, which may include information from the request.

", "example": "paymentDetails.startDate must be future date", "default": "paymentDetails.startDate must be future date", "pattern": "^.+$" } ] } ], "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.ErrorResponse", "isExpanded": true } ] } ], "hasXCodeSamples": false, "examples": { "languages": [ { "id": "example-0-curl", "language": "curl", "label": "cURL", "code": "curl --request PATCH \\\n --url https://api-beta.monoova.com/au/payto/pam-v1/PaymentSchedule/{scheduleId}/status \\\n --header 'accept: application/json' \\\n --header 'content-type: application/json' \\\n --data '{\n \"status\": \"Paused\",\n \"statusReasonDescription\": \"Customer requested a pause in payments\"\n }'" }, { "id": "example-1-javascript", "language": "javascript", "label": "javascript", "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar raw = JSON.stringify({\n \"status\": \"Paused\",\n \"statusReasonDescription\": \"Customer requested a pause in payments\"\n});\n\nvar requestOptions = {\n method: 'PATCH',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"https://api-beta.monoova.com/au/payto/pam-v1/PaymentSchedule/{scheduleId}/status\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));" }, { "id": "example-2-ruby", "language": "ruby", "label": "Ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api-beta.monoova.com/au/payto/pam-v1/PaymentSchedule/{scheduleId}/status\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Patch.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest.body = JSON.dump({\n \"status\": \"Paused\",\n \"statusReasonDescription\": \"Customer requested a pause in payments\"\n})\n\nresponse = https.request(request)\nputs response.read_body\n" }, { "id": "example-3-python", "language": "python", "label": "Python", "code": "import requests\nimport json\n\nurl = \"https://api-beta.monoova.com/au/payto/pam-v1/PaymentSchedule/{scheduleId}/status\"\n\npayload = json.dumps({\n \"status\": \"Paused\",\n \"statusReasonDescription\": \"Customer requested a pause in payments\"\n})\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json'\n}\n\nresponse = requests.request(\"PATCH\", url, headers=headers, data=payload)\n\nprint(response.text)\n" } ], "selectedLanguageId": "example-0-curl" }, "results": { "languages": [ { "id": "response-0-200", "language": "200", "code": "// OK. The payment schedule status was changed.\n{\n \"traceId\": \"1dabfaa9-abe8-4d2d-a69a-b723079d84ed\",\n \"scheduleId\": \"MONSCH12345\",\n \"status\": \"Paused\",\n \"statusDescription\": \"Paused\",\n \"statusReasonCode\": \"CustReq\",\n \"statusReasonDescription\": \"Customer requested a pause in payments\"\n}" }, { "id": "response-1-400", "language": "400", "code": "// Bad Request. The request failed validation. See errors for details.\n{\n \"traceId\": \"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\n \"errors\": [\n {\n \"errorCode\": \"PAM_STARTDATE_EARLY\",\n \"errorMessage\": \"paymentDetails.startDate must be future date\"\n }\n ]\n}" }, { "id": "response-2-401", "language": "401", "code": "// Unauthorized. The bearer token is missing, invalid or expired. Bearer tokens are valid for 24 hours; generate a new token and retry.\n" }, { "id": "response-3-403", "language": "403", "code": "// Forbidden. Your account is not permitted to perform this operation.\n{\n \"traceId\": \"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\n \"errors\": [\n {\n \"errorCode\": \"PAM_STARTDATE_EARLY\",\n \"errorMessage\": \"paymentDetails.startDate must be future date\"\n }\n ]\n}" }, { "id": "response-4-404", "language": "404", "code": "// Not Found. The payment schedule could not be found.\n{\n \"traceId\": \"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\n \"errors\": [\n {\n \"errorCode\": \"PAM_STARTDATE_EARLY\",\n \"errorMessage\": \"paymentDetails.startDate must be future date\"\n }\n ]\n}" }, { "id": "response-5-500", "language": "500", "code": "// Internal Server Error. An unexpected error occurred. Contact Monoova support if the problem persists.\n{\n \"traceId\": \"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\n \"errors\": [\n {\n \"errorCode\": \"PAM_STARTDATE_EARLY\",\n \"errorMessage\": \"paymentDetails.startDate must be future date\"\n }\n ]\n}" }, { "id": "response-6-502", "language": "502", "code": "// Bad Gateway. An upstream service, such as the NPP gateway, returned an error. Retry the request later.\n{\n \"traceId\": \"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\n \"errors\": [\n {\n \"errorCode\": \"PAM_STARTDATE_EARLY\",\n \"errorMessage\": \"paymentDetails.startDate must be future date\"\n }\n ]\n}" }, { "id": "response-7-503", "language": "503", "code": "// Service Unavailable. The service is temporarily unavailable. Retry the request later.\n" }, { "id": "response-8-504", "language": "504", "code": "// Gateway Timeout. An upstream service, such as the NPP gateway, did not respond in time. Retry the request later.\n{\n \"traceId\": \"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\n \"errors\": [\n {\n \"errorCode\": \"PAM_STARTDATE_EARLY\",\n \"errorMessage\": \"paymentDetails.startDate must be future date\"\n }\n ]\n}" } ], "selectedLanguageId": "response-0-200" } }, "children": [ { "text": "" } ] }