Intermediary Agents

Part of the FX Service. Used by PSPs.

Get intermediary agents (FXP accounts) for a specific quote

A Nexus payment flows through accounts held by an FX Provider in both the Source IPS and Destination IPS. These accounts need to be defined in the pacs.008 so that both IPSs know which accounts to debit and credit.

In the pacs.008, ISO 20022 terminology is used:

  • Each Settlement Account Provider is defined as an Intermediary Agent

  • The FXP's account at the SAP is defined as an Intermediary Agent Account

For any specific quote, the Intermediary Agents (ie the FXP’s accounts) can be retrieved from Nexus by the GET /intermediaryagents/ API operation with the ID of the preferred quote:

Get intermediary agents for a specific quote

GET https://local.nexus.gateway/api/v1/intermediaryagents/

The response is automatically formatted in the structure required for the pacs.008 payment instruction that will be sent by the Source PSP to the Source IPS

Path Parameters

NameTypeDescription

quote_id*

String

Id of the specific quote selected by the Source PSP

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<GtIntrmyAgtRspn xmlns="https://nexus.bisih.org/nexus.fxqt.002.001.01">
  <GrpHdr>
    <MsgID>EURSGD20230125001757268</MsgID>
    <CreDtTm>2023-01-25T00:17:57.268Z</CreDtTm>
  </GrpHdr>
  <OrgnlGrpInf>
    <OrgnlQtId>05201109-1cf1-42ba-b661-32d9f6bc8b63</OrgnlQtId>
  </OrgnlGrpInf>
  <IntrmyRspn>
    <RspnSts>ACTC</RspnSts>
  </IntrmyRspn>
  <IntrmyAgtRspn>
    <FXPId>
      <BICFI>NEXUITMMSAP</BICFI>
    </FXPId>
    <AgrdRate>
      <XchgRate>1.6634</XchgRate>
      <UnitCcy>EUR</UnitCcy>
      <QtdCcy>SGD</QtdCcy>
    </AgrdRate>
    <SrcIPSId>EURTIPS</SrcIPSId>
    <DestIPSId>SGDFAST</DestIPSId>
    <IntrmyAgt1>
      <FinInstnId>
        <BICFI>NEXUITMMSAP</BICFI>
      </FinInstnId>
    </IntrmyAgt1>
    <IntrmyAgt2>
      <FinInstnId>
        <Othr>
          <Id>UUUBSGSG</Id>
        </Othr>
      </FinInstnId>
    </IntrmyAgt2>
    <IntrmyAgt1Acct>
      <Id>
        <IBAN>IT10EURNEXUITSAPXXACCOUNT</IBAN>
      </Id>
      <Tp>
        <Cd>SACC</Cd>
      </Tp>
      <Ccy>EUR</Ccy>
      <Nm>Source Settlement Account</Nm>
    </IntrmyAgt1Acct>
    <IntrmyAgt2Acct>
      <Id>
        <Othr>
          <Id>39912322939</Id>
        </Othr>
      </Id>
      <Tp>
        <Cd>SACC</Cd>
      </Tp>
      <Ccy>SGD</Ccy>
      <Nm>Destination Settlement Account</Nm>
    </IntrmyAgt2Acct>
  </IntrmyAgtRspn>
</GtIntrmyAgtRspn>

Last updated