Skip to main content

Initiate a request to withdraw from your network accounts

POST 

/v1/defund

ISO-20022 pacs.009 message. Withdraw from an account on the RTGS.global network.

When withdrawing funds from your network account, the debtor fields of the request (FICdtTrf.CdtTrfTxInf[0].Dbtr and FICdtTrf.CdtTrfTxInf[0].DbtrAcct) pertain to your network account, and the creditor fields pertain to the beneficiary being paid.

Verto-specific behaviour

  • FICdtTrf.CdtTrfTxInf[0].DbtrAcct.Id.Othr.Id must be your Verto wallet, in the format VRTW-<companyId>-<walletId>. The wallet must hold the currency of IntrBkSttlmAmt and have sufficient balance.
  • FICdtTrf.CdtTrfTxInf[0].Cdtr.FinInstnId.Othr.Id must be the creditor's account alias id registered via Party Management, in the format VRTB-<companyId>-<beneficiaryId>. The beneficiary must accept the currency of IntrBkSttlmAmt.
  • FICdtTrf.CdtTrfTxInf[0].Dbtr.FinInstnId and FICdtTrf.CdtTrfTxInf[0].Cdtr.FinInstnId must each include exactly one of BICFI or LEI.
  • FICdtTrf.CdtTrfTxInf[0].Purp.Prtry is the purpose of the withdrawal, using the same codes as Payaway. If it is omitted, INTC (Internal Company Transfer) is used.
  • The wallet and beneficiary are checked after the request is accepted. If either check fails, this is reported in a transaction status notification.

Request​

Responses​

Accepted