Skip to main content

Initiate FI to FI Customer Credit Transfer

POST 
/v1/payaway/funds-controller

ISO-20022 pacs.008 message. Instruct TransferMate to initiate onward payment to beneficiaries in other countries.

On success, the pacs.008 message will be sent to TransferMate to inform them of the onward payment requests.

On failure, the initiating party's webhook will receive a notification with the reason.

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​

Accepted