Unilateral Amendment Async
PATCH
https://beta-api.monoova.com/au/payto/pam-v1/PaymentAgreementAsync/{paymentAgreementUID}/unilateral
Path Parameters
- paymentAgreementUIDstringrequiredExampleDescriptionDefaultMONPAG12345Pattern^[a-zA-Z0-9_-]{1,35}$
Body Parameters
- bodyMandateManager.Application.Common.Dtos.AmendUnilateralDetailsDtorequiredDescription
- descriptionstringExampleDescriptionDefaultMonthly subscription for ABC Corp servicesMin Length1Max Length140Pattern^[ -~]{1,140}$
- shortDescriptionstringExampleDescriptionDefaultABC Corp subscriptionMin Length1Max Length35Pattern^[ -~]{1,35}$
- payeeDetailsMandateManager.Application.Common.Dtos.PayeeDetailsDtoDescription
- payeeTypestringExampleDescriptionDefaultORGNPattern^(ORGN|PERS)$
- payeeLinkedBsbstringExampleDescriptionDefault062000Pattern^[0-9]{3}-?[0-9]{3}$
- payeeLinkedAccountstringExampleDescriptionDefault12345678Min Length1Max Length28Pattern^[0-9A-Za-z -]{1,28}$
- payeeLinkedPayIdstringExampleDescriptionDefaultPattern^[ -~]{1,256}$
- payeeLinkedPayIdTypestringExampleDescriptionDefaultEmailPattern^(PhoneNumber|Email|ABN|ACN|OrganisationId)$
- payeeAccountNamestringExampleDescriptionDefaultABC Corp Pty LtdMin Length1Max Length140Pattern^[ -~]{1,140}$
- ultimatePayeestringExampleDescriptionDefaultABC CorpMin Length1Max Length140Pattern^[ -~]{1,140}$
- payeeMCCCodestringExampleDescriptionDefault5968Pattern^([0-9]{4}|-)$
- ultimatePayeeMCCCodestringExampleDescriptionDefault5968Pattern^([0-9]{4}|-)$
Responses
202
- MandateManager.Application.Common.Dtos.AsyncResponseDescription
- traceIdstringExampleDescriptionDefault1dabfaa9-abe8-4d2d-a69a-b723079d84edPattern^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
- uniqueRequestIdstringExampleDescriptionDefault4834dba5-27b0-465c-aea7-aa530315c68cPattern^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
400
- MandateManager.Application.Common.Dtos.ErrorResponseExample
{ "traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "errors": [ { "errorCode": "PAM_AMEND_FORBIDDEN", "errorMessage": "Can only amend payment agreement in active or paused status" } ] }Description- traceIdstringExampleDescriptionDefault4ea61012-2d9b-413d-a5b4-90ad69a68741Pattern^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
- errorsMandateManager.Application.Common.Dtos.ErrorDto[]Description
- errorCodestringExampleDescriptionDefaultPAM_STARTDATE_EARLYPattern^[A-Z]{3}_[A-Z0-9_]+$
- errorMessagestringExampleDescriptionDefaultpaymentDetails.startDate must be future datePattern^.+$
401
403
- MandateManager.Application.Common.Dtos.ErrorResponseExample
{ "traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "errors": [ { "errorCode": "PAM_FORBIDDEN_ERROR", "errorMessage": "Not allowed to amend payment agreement for account 6279059778044302" } ] }Description- traceIdstringExampleDescriptionDefault4ea61012-2d9b-413d-a5b4-90ad69a68741Pattern^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
- errorsMandateManager.Application.Common.Dtos.ErrorDto[]Description
- errorCodestringExampleDescriptionDefaultPAM_STARTDATE_EARLYPattern^[A-Z]{3}_[A-Z0-9_]+$
- errorMessagestringExampleDescriptionDefaultpaymentDetails.startDate must be future datePattern^.+$
404
- MandateManager.Application.Common.Dtos.ErrorResponseExample
{ "traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "errors": [ { "errorCode": "PAM_PAG_NOT_FOUND_ERROR", "errorMessage": "PaymentAgreement not found for PaymentAgreementUID MONPAG12345" } ] }Description- traceIdstringExampleDescriptionDefault4ea61012-2d9b-413d-a5b4-90ad69a68741Pattern^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
- errorsMandateManager.Application.Common.Dtos.ErrorDto[]Description
- errorCodestringExampleDescriptionDefaultPAM_STARTDATE_EARLYPattern^[A-Z]{3}_[A-Z0-9_]+$
- errorMessagestringExampleDescriptionDefaultpaymentDetails.startDate must be future datePattern^.+$
500
- MandateManager.Application.Common.Dtos.ErrorResponseExample
{ "traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "errors": [ { "errorCode": "PAM_UNEXPECTED_ERROR", "errorMessage": "Internal server error. Please contact Monoova support." } ] }Description- traceIdstringExampleDescriptionDefault4ea61012-2d9b-413d-a5b4-90ad69a68741Pattern^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
- errorsMandateManager.Application.Common.Dtos.ErrorDto[]Description
- errorCodestringExampleDescriptionDefaultPAM_STARTDATE_EARLYPattern^[A-Z]{3}_[A-Z0-9_]+$
- errorMessagestringExampleDescriptionDefaultpaymentDetails.startDate must be future datePattern^.+$
502
- MandateManager.Application.Common.Dtos.ErrorResponseExample
{ "traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "errors": [ { "errorCode": "PAM_NPP_GATEWAY_ERROR", "errorMessage": "Error returned from NPP gateway - service unavailable" } ] }Description- traceIdstringExampleDescriptionDefault4ea61012-2d9b-413d-a5b4-90ad69a68741Pattern^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
- errorsMandateManager.Application.Common.Dtos.ErrorDto[]Description
- errorCodestringExampleDescriptionDefaultPAM_STARTDATE_EARLYPattern^[A-Z]{3}_[A-Z0-9_]+$
- errorMessagestringExampleDescriptionDefaultpaymentDetails.startDate must be future datePattern^.+$
504
- MandateManager.Application.Common.Dtos.ErrorResponseExample
{ "traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741", "errors": [ { "errorCode": "PAM_NPP_GATEWAY_TIMEOUT", "errorMessage": "Timeout from NPP gateway" } ] }Description- traceIdstringExampleDescriptionDefault4ea61012-2d9b-413d-a5b4-90ad69a68741Pattern^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
- errorsMandateManager.Application.Common.Dtos.ErrorDto[]Description
- errorCodestringExampleDescriptionDefaultPAM_STARTDATE_EARLYPattern^[A-Z]{3}_[A-Z0-9_]+$
- errorMessagestringExampleDescriptionDefaultpaymentDetails.startDate must be future datePattern^.+$
curl
curl --request PATCH \
--url https://beta-api.monoova.com/au/payto/pam-v1/PaymentAgreementAsync/{paymentAgreementUID}/unilateral \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data-raw '{
"description": "Monthly subscription for ABC Corp services",
"shortDescription": "ABC Corp subscription",
"payeeDetails": {
"payeeType": "ORGN",
"payeeLinkedBsb": "062000",
"payeeLinkedAccount": "12345678",
"payeeLinkedPayId": "[email protected]",
"payeeLinkedPayIdType": "Email",
"payeeAccountName": "ABC Corp Pty Ltd",
"ultimatePayee": "ABC Corp",
"payeeMCCCode": "5968",
"ultimatePayeeMCCCode": "5968"
}
}'javascript
var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
var raw = JSON.stringify({
"description": "Monthly subscription for ABC Corp services",
"shortDescription": "ABC Corp subscription",
"payeeDetails": {
"payeeType": "ORGN",
"payeeLinkedBsb": "062000",
"payeeLinkedAccount": "12345678",
"payeeLinkedPayId": "[email protected]",
"payeeLinkedPayIdType": "Email",
"payeeAccountName": "ABC Corp Pty Ltd",
"ultimatePayee": "ABC Corp",
"payeeMCCCode": "5968",
"ultimatePayeeMCCCode": "5968"
}
});
var requestOptions = {
method: 'PATCH',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://beta-api.monoova.com/au/payto/pam-v1/PaymentAgreementAsync/{paymentAgreementUID}/unilateral", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));ruby
require "uri"
require "json"
require "net/http"
url = URI("https://beta-api.monoova.com/au/payto/pam-v1/PaymentAgreementAsync/{paymentAgreementUID}/unilateral")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
"description": "Monthly subscription for ABC Corp services",
"shortDescription": "ABC Corp subscription",
"payeeDetails": {
"payeeType": "ORGN",
"payeeLinkedBsb": "062000",
"payeeLinkedAccount": "12345678",
"payeeLinkedPayId": "[email protected]",
"payeeLinkedPayIdType": "Email",
"payeeAccountName": "ABC Corp Pty Ltd",
"ultimatePayee": "ABC Corp",
"payeeMCCCode": "5968",
"ultimatePayeeMCCCode": "5968"
}
})
response = https.request(request)
puts response.read_body
python
import requests
import json
url = "https://beta-api.monoova.com/au/payto/pam-v1/PaymentAgreementAsync/{paymentAgreementUID}/unilateral"
payload = json.dumps({
"description": "Monthly subscription for ABC Corp services",
"shortDescription": "ABC Corp subscription",
"payeeDetails": {
"payeeType": "ORGN",
"payeeLinkedBsb": "062000",
"payeeLinkedAccount": "12345678",
"payeeLinkedPayId": "[email protected]",
"payeeLinkedPayIdType": "Email",
"payeeAccountName": "ABC Corp Pty Ltd",
"ultimatePayee": "ABC Corp",
"payeeMCCCode": "5968",
"ultimatePayeeMCCCode": "5968"
}
})
headers = {
'accept': 'application/json',
'content-type': 'application/json'
}
response = requests.request("PATCH", url, headers=headers, data=payload)
print(response.text)
202
// Accepted. The request was validated and accepted for background processing. Use uniqueRequestId to check its status.
{
"traceId": "1dabfaa9-abe8-4d2d-a69a-b723079d84ed",
"uniqueRequestId": "4834dba5-27b0-465c-aea7-aa530315c68c"
}400
// Bad Request. The request failed validation. See errors for details.
{
"traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741",
"errors": [
{
"errorCode": "PAM_STARTDATE_EARLY",
"errorMessage": "paymentDetails.startDate must be future date"
}
]
}401
// Unauthorized. The bearer token is missing, invalid or expired. Bearer tokens are valid for 24 hours; generate a new token and retry.
403
// Forbidden. Your account is not permitted to perform this operation.
{
"traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741",
"errors": [
{
"errorCode": "PAM_STARTDATE_EARLY",
"errorMessage": "paymentDetails.startDate must be future date"
}
]
}404
// Not Found. The payment agreement could not be found.
{
"traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741",
"errors": [
{
"errorCode": "PAM_STARTDATE_EARLY",
"errorMessage": "paymentDetails.startDate must be future date"
}
]
}500
// Internal Server Error. An unexpected error occurred. Contact Monoova support if the problem persists.
{
"traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741",
"errors": [
{
"errorCode": "PAM_STARTDATE_EARLY",
"errorMessage": "paymentDetails.startDate must be future date"
}
]
}502
// Bad Gateway. An upstream service, such as the NPP gateway, returned an error. Retry the request later.
{
"traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741",
"errors": [
{
"errorCode": "PAM_STARTDATE_EARLY",
"errorMessage": "paymentDetails.startDate must be future date"
}
]
}504
// Gateway Timeout. An upstream service, such as the NPP gateway, did not respond in time. Retry the request later.
{
"traceId": "4ea61012-2d9b-413d-a5b4-90ad69a68741",
"errors": [
{
"errorCode": "PAM_STARTDATE_EARLY",
"errorMessage": "paymentDetails.startDate must be future date"
}
]
}