--- title: Get Async Payment Agreement Request Status slug: r10-integration/get-async-payment-agreement-request-status createdAt: 2026-10-29T06:44:31.903Z --- { "id": "ZtRCM1zZ4OFn99_I2kYoW", "type": "api-oas-v2", "data": { "method": "GET", "url": "https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreementAsync/request/{uniqueRequestId}", "servers": [ { "url": "https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreementAsync/request/{uniqueRequestId}", "description": "Beta Sandbox URL" } ], "name": "Get Async Payment Agreement Request Status", "description": "Queries the status of an asynchronous API request for creating a payment agreement. This endpoint requires the uniqueRequestId returned by the original Async API call.", "contentType": "application/json", "request": { "pathParameters": [ { "kind": "required", "name": "uniqueRequestId", "type": "string", "example": "4834dba5-27b0-465c-aea7-aa530315c68c", "description": "

The uniqueRequestId returned by a previous async request.

", "default": "4834dba5-27b0-465c-aea7-aa530315c68c", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" } ], "headerParameters": [ { "name": "accept", "type": "string", "kind": "optional", "description": "Generated from available response content types", "enum": [ "application/json" ], "default": "application/json" } ], "queryParameters": [], "bodyDataParameters": [], "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 request is still being processed.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "example": "{\"traceId\":\"1dabfaa9-abe8-4d2d-a69a-b723079d84ed\",\"uniqueRequestId\":\"4834dba5-27b0-465c-aea7-aa530315c68c\",\"accountId\":\"6279059778044302\",\"paymentAgreementUID\":\"MONPAG12345\",\"status\":\"Processing\"}", "description": "Status of an asynchronous request.", "customType": "MandateManager.Application.Common.Dtos.AsyncJobResponse", "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": "uniqueRequestId", "kind": "optional", "type": "string", "nullable": true, "description": "

Server-generated unique ID of the async request.

", "example": "4834dba5-27b0-465c-aea7-aa530315c68c", "default": "4834dba5-27b0-465c-aea7-aa530315c68c", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, { "name": "accountId", "kind": "optional", "type": "string", "nullable": true, "description": "

mAccount number (16 digits) of the account that submitted the request.

", "example": "6279059778044302", "default": "6279059778044302", "pattern": "^[0-9]{16}$" }, { "name": "paymentAgreementUID", "kind": "optional", "type": "string", "nullable": true, "description": "

The paymentAgreementUID supplied in the request.

", "example": "MONPAG12345", "default": "MONPAG12345", "pattern": "^[a-zA-Z0-9_-]{1,35}$" }, { "name": "location", "kind": "optional", "type": "string", "nullable": true, "description": "URL of the created or updated resource. Returned when the request completes.", "example": "https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreement/MONPAG12345", "default": "https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreement/MONPAG12345", "format": "uri", "pattern": "^https://.+$" }, { "name": "status", "kind": "optional", "type": "string", "nullable": true, "description": "

Current status of the request. Possible values: Accepted, Processing, Completed, Failed, Expired.

", "example": "Processing", "default": "Processing", "pattern": "^(Accepted|Processing|Completed|Failed|Expired)$" }, { "name": "errorCode", "kind": "optional", "type": "string", "nullable": true, "description": "Error code that indicates why the request failed. Returned when the request fails.", "example": "PAM_PAG_EXISTS", "default": "PAM_PAG_EXISTS", "pattern": "^[A-Z]{3}_[A-Z0-9_]+$" }, { "name": "errorMessage", "kind": "optional", "type": "string", "nullable": true, "description": "Detailed message that explains why the request failed. Returned when the request fails.", "example": "Failed to create payment agreement - PaymentAgreementUID already linked to mmsId", "default": "Failed to create payment agreement - PaymentAgreementUID already linked to mmsId", "pattern": "^.+$" } ], "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.AsyncJobResponse", "isExpanded": true } ] }, { "statusCode": "201", "description": "

Created. The request completed successfully. location contains the URL of the created or updated resource.

", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "example": "{\"traceId\":\"1dabfaa9-abe8-4d2d-a69a-b723079d84ed\",\"uniqueRequestId\":\"4834dba5-27b0-465c-aea7-aa530315c68c\",\"accountId\":\"6279059778044302\",\"paymentAgreementUID\":\"MONPAG12345\",\"location\":\"https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreement/MONPAG12345\",\"status\":\"Completed\"}", "description": "Status of an asynchronous request.", "customType": "MandateManager.Application.Common.Dtos.AsyncJobResponse", "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": "uniqueRequestId", "kind": "optional", "type": "string", "nullable": true, "description": "

Server-generated unique ID of the async request.

", "example": "4834dba5-27b0-465c-aea7-aa530315c68c", "default": "4834dba5-27b0-465c-aea7-aa530315c68c", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, { "name": "accountId", "kind": "optional", "type": "string", "nullable": true, "description": "

mAccount number (16 digits) of the account that submitted the request.

", "example": "6279059778044302", "default": "6279059778044302", "pattern": "^[0-9]{16}$" }, { "name": "paymentAgreementUID", "kind": "optional", "type": "string", "nullable": true, "description": "

The paymentAgreementUID supplied in the request.

", "example": "MONPAG12345", "default": "MONPAG12345", "pattern": "^[a-zA-Z0-9_-]{1,35}$" }, { "name": "location", "kind": "optional", "type": "string", "nullable": true, "description": "URL of the created or updated resource. Returned when the request completes.", "example": "https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreement/MONPAG12345", "default": "https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreement/MONPAG12345", "format": "uri", "pattern": "^https://.+$" }, { "name": "status", "kind": "optional", "type": "string", "nullable": true, "description": "

Current status of the request. Possible values: Accepted, Processing, Completed, Failed, Expired.

", "example": "Processing", "default": "Processing", "pattern": "^(Accepted|Processing|Completed|Failed|Expired)$" }, { "name": "errorCode", "kind": "optional", "type": "string", "nullable": true, "description": "Error code that indicates why the request failed. Returned when the request fails.", "example": "PAM_PAG_EXISTS", "default": "PAM_PAG_EXISTS", "pattern": "^[A-Z]{3}_[A-Z0-9_]+$" }, { "name": "errorMessage", "kind": "optional", "type": "string", "nullable": true, "description": "Detailed message that explains why the request failed. Returned when the request fails.", "example": "Failed to create payment agreement - PaymentAgreementUID already linked to mmsId", "default": "Failed to create payment agreement - PaymentAgreementUID already linked to mmsId", "pattern": "^.+$" } ], "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.AsyncJobResponse", "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_JOBID_INVALID\",\"errorMessage\":\"uniqueRequestId 4834dba5 is invalid\"}]}", "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 get async request 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 async request could not be found.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "example": "{\"traceId\":\"4ea61012-2d9b-413d-a5b4-90ad69a68741\",\"errors\":[{\"errorCode\":\"PAM_JOB_NOT_FOUND_ERROR\",\"errorMessage\":\"Request not found for uniqueRequestId 4834dba5-27b0-465c-aea7-aa530315c68c\"}]}", "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": "422", "description": "

Unprocessable Content. The background job failed. See errorCode and errorMessage for the reason.

", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "example": "{\"traceId\":\"1dabfaa9-abe8-4d2d-a69a-b723079d84ed\",\"uniqueRequestId\":\"4834dba5-27b0-465c-aea7-aa530315c68c\",\"accountId\":\"6279059778044302\",\"paymentAgreementUID\":\"MONPAG12345\",\"status\":\"Failed\",\"errorCode\":\"PAM_PAG_EXISTS\",\"errorMessage\":\"Failed to create payment agreement - PaymentAgreementUID already linked to mmsId\"}", "description": "Status of an asynchronous request.", "customType": "MandateManager.Application.Common.Dtos.AsyncJobResponse", "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": "uniqueRequestId", "kind": "optional", "type": "string", "nullable": true, "description": "

Server-generated unique ID of the async request.

", "example": "4834dba5-27b0-465c-aea7-aa530315c68c", "default": "4834dba5-27b0-465c-aea7-aa530315c68c", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, { "name": "accountId", "kind": "optional", "type": "string", "nullable": true, "description": "

mAccount number (16 digits) of the account that submitted the request.

", "example": "6279059778044302", "default": "6279059778044302", "pattern": "^[0-9]{16}$" }, { "name": "paymentAgreementUID", "kind": "optional", "type": "string", "nullable": true, "description": "

The paymentAgreementUID supplied in the request.

", "example": "MONPAG12345", "default": "MONPAG12345", "pattern": "^[a-zA-Z0-9_-]{1,35}$" }, { "name": "location", "kind": "optional", "type": "string", "nullable": true, "description": "URL of the created or updated resource. Returned when the request completes.", "example": "https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreement/MONPAG12345", "default": "https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreement/MONPAG12345", "format": "uri", "pattern": "^https://.+$" }, { "name": "status", "kind": "optional", "type": "string", "nullable": true, "description": "

Current status of the request. Possible values: Accepted, Processing, Completed, Failed, Expired.

", "example": "Processing", "default": "Processing", "pattern": "^(Accepted|Processing|Completed|Failed|Expired)$" }, { "name": "errorCode", "kind": "optional", "type": "string", "nullable": true, "description": "Error code that indicates why the request failed. Returned when the request fails.", "example": "PAM_PAG_EXISTS", "default": "PAM_PAG_EXISTS", "pattern": "^[A-Z]{3}_[A-Z0-9_]+$" }, { "name": "errorMessage", "kind": "optional", "type": "string", "nullable": true, "description": "Detailed message that explains why the request failed. Returned when the request fails.", "example": "Failed to create payment agreement - PaymentAgreementUID already linked to mmsId", "default": "Failed to create payment agreement - PaymentAgreementUID already linked to mmsId", "pattern": "^.+$" } ], "modelRef": "#/components/schemas/MandateManager.Application.Common.Dtos.AsyncJobResponse", "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_NPP_GATEWAY_ERROR\",\"errorMessage\":\"Error returned from NPP gateway - 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": "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_NPP_GATEWAY_TIMEOUT\",\"errorMessage\":\"Timeout from NPP gateway\"}]}", "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 GET \\\n --url https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreementAsync/request/{uniqueRequestId} \\\n --header 'accept: application/json'" }, { "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 requestOptions = {\n method: 'GET',\n headers: myHeaders,\n redirect: 'follow'\n};\n\nfetch(\"https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreementAsync/request/{uniqueRequestId}\", 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/PaymentAgreementAsync/request/{uniqueRequestId}\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\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/PaymentAgreementAsync/request/{uniqueRequestId}\"\n\npayload = {}\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json'\n}\n\nresponse = requests.request(\"GET\", 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 request is still being processed.\n{\n \"traceId\": \"1dabfaa9-abe8-4d2d-a69a-b723079d84ed\",\n \"uniqueRequestId\": \"4834dba5-27b0-465c-aea7-aa530315c68c\",\n \"accountId\": \"6279059778044302\",\n \"paymentAgreementUID\": \"MONPAG12345\",\n \"location\": \"https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreement/MONPAG12345\",\n \"status\": \"Processing\",\n \"errorCode\": \"PAM_PAG_EXISTS\",\n \"errorMessage\": \"Failed to create payment agreement - PaymentAgreementUID already linked to mmsId\"\n}" }, { "id": "response-1-201", "language": "201", "code": "// Created. The request completed successfully. location contains the URL of the created or updated resource.\n{\n \"traceId\": \"1dabfaa9-abe8-4d2d-a69a-b723079d84ed\",\n \"uniqueRequestId\": \"4834dba5-27b0-465c-aea7-aa530315c68c\",\n \"accountId\": \"6279059778044302\",\n \"paymentAgreementUID\": \"MONPAG12345\",\n \"location\": \"https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreement/MONPAG12345\",\n \"status\": \"Processing\",\n \"errorCode\": \"PAM_PAG_EXISTS\",\n \"errorMessage\": \"Failed to create payment agreement - PaymentAgreementUID already linked to mmsId\"\n}" }, { "id": "response-2-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-3-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-4-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-5-404", "language": "404", "code": "// Not Found. The async request 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-6-422", "language": "422", "code": "// Unprocessable Content. The background job failed. See errorCode and errorMessage for the reason.\n{\n \"traceId\": \"1dabfaa9-abe8-4d2d-a69a-b723079d84ed\",\n \"uniqueRequestId\": \"4834dba5-27b0-465c-aea7-aa530315c68c\",\n \"accountId\": \"6279059778044302\",\n \"paymentAgreementUID\": \"MONPAG12345\",\n \"location\": \"https://api-beta.monoova.com/au/payto/pam-v1/PaymentAgreement/MONPAG12345\",\n \"status\": \"Processing\",\n \"errorCode\": \"PAM_PAG_EXISTS\",\n \"errorMessage\": \"Failed to create payment agreement - PaymentAgreementUID already linked to mmsId\"\n}" }, { "id": "response-7-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-8-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-9-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": "" } ] }