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 Realis Finance network account, and the creditor fields pertain to your off-network account.

Realis Finance — Purpose code required

FICdtTrf.CdtTrfTxInf[0].Purp is mandatory for Realis Finance. Either Purp.Cd or Purp.Prtry (not both) must be set to a value from the Realis Finance supported purpose code list — an ISO 20022 ExternalPurpose1Code subset including SALA, BONU, TRAD, INTC, and approximately 107 other values.

A missing or unsupported purpose code is not caught synchronously. The request returns 202 Accepted, but is rejected asynchronously: a RJCT pacs.002 status notification is delivered to your webhook with StsRsnInf[].AddtlInf containing FundsControllerValidationFailed.

Account identifiers

FICdtTrf.CdtTrfTxInf[0].DbtrAcct.Id must use Othr.Id with your Realis Finance network account identifier (max 40 characters). IBAN is not supported.

FICdtTrf.CdtTrfTxInf[0].Cdtr.FinInstnId.Othr.Id must be the Realis Finance beneficiary client reference registered via Party Management, not an RTGS.global ID.

Request​

Responses​

Accepted