Skip to main content

Validate a FI to FI Customer Credit Transfer request

POST 
/v1/payaway/validate

ISO-20022 pacs.008 message. Synchronously validate FI to FI Customer Credit Transfer request. The validation logic applied by this endpoint is identical to the logic applied by the /v1/payaway/funds-controller endpoint.

On success, a 204 response will be returned immediately.

On failure, a 400 response will be returned immediately with details of the validation failures.

The InstgAgt.FinInstnId.Othr.Id and InstdAgt.FinInstnId.Othr.Id properties must be populated with the RTGS.global Ids of the debtor participant and TransferMate respectively.

The creditor's account alias id must always be provided. This is the Id of a creditor registered via the Party Management endpoints. If the creditor is an individual, use FIToFICstmrCdtTrf.CdtTrfTxInf[0].Cdtr.Id.PrvtId.Othr[0].Id, otherwise use FIToFICstmrCdtTrf.CdtTrfTxInf[0].Cdtr.Id.OrgId.Othr[0].Id.

The debtor's account alias id determines the payment flow. Omit it for a first-party payment (the participant is paying on their own behalf). Provide it for a third-party payment (paying on behalf of someone else), using FIToFICstmrCdtTrf.CdtTrfTxInf[0].Dbtr.Id.PrvtId.Othr[0].Id (individual) or FIToFICstmrCdtTrf.CdtTrfTxInf[0].Dbtr.Id.OrgId.Othr[0].Id (organisation). The value must be numeric. First-party participants must not provide a debtor alias id; doing so will result in rejection with reason code AG01 (TransactionForbidden).

FIToFICstmrCdtTrf.CdtTrfTxInf[0].IntrBkSttlmAmt.Value must not exceed 11 digits in total, with a maximum of 2 decimal places.

Request​

Responses​

No Content