Skip to main content

Validate a FI to FI Customer Credit Transfer request

POST 

/v1/payaway/validate

Synchronously validate a FI to FI Customer Credit Transfer (pacs.008) payload against the Verto Funds Controller without executing the transfer. The validation logic is identical to that applied by Initiate FI to FI Customer Credit Transfer.

Returns 204 No Content on success, or 400 Bad Request with validation failure details.

Verto-specific field requirements​

The following fields in CdtTrfTxInf[*] are required or consumed by the Verto adapter in addition to the base ISO 20022 schema:

  • Cdtr.Id.OrgId.Othr[0].Id — the Verto beneficiary reference obtained from GET /v2/creditors.

  • InstgAgt.FinInstnId.Othr.Id — the Verto wallet reference for the instructing agent.

  • UltmtDbtr.Id — the ultimate debtor identifier must be present.

  • InitgPty.PstlAdr.Ctry — initiating party postal country must be provided.

  • For individual senders (Dbtr with PrvtId):

    • PrvtId.Othr[0].Issr — nationality of the sender.
    • PrvtId.DtAndPlcOfBirth.BirthDt — date of birth of the sender.
  • For company senders (Dbtr with OrgId):

    • OrgId.Othr[0].Issr — country of registration of the sender company.
  • RmtInf.Strd[0].RfrdDocInf[0].Nb — required. The ExternalReference key returned by Initiate a supporting document upload.

Amount precision​

IntrBkSttlmAmt must not exceed 13 integer digits. The number of fractional digits must not exceed the lower of 5 or the standard decimal places for the settlement currency (e.g. JPY accepts 0, USD accepts 2, EUR accepts 2).

Purpose codes​

The CdtTrfTxInf[*].Purp.Prtry field must contain one of the following values:

CodeDescription
GDDSPurchase of Goods
SERVPurchase of Professional Services
FEESProfessional Fees Payment
SALAPayroll / Personnel Payment
LOANPayment for Loan or Deposit
BEXPBill Payment
R&DVResearch and Development
FAMTPayment Family Assistance
HLTCMedical Assistance
COMCRemittance of Funds from E-Commerce
ROYTIP / Trademark / Patent Work
TRVLTravel / Hospitality
SECUInvestment
INTCInternal Company Transfer

DEPT (Wallet Top Up) is not supported. If Purp.Prtry is omitted or unrecognised, the code defaults to INTC (Internal Company Transfer).

Request​

Responses​

No Content