Diagnostic Exchange

5 min

this section is incomplete a diagnostic exchange is composed of an acceptordiagnosticrequest message and an acceptordiagnosticresponse message an acceptordiagnosticrequest is a message sent by an initiating party to a recipient party to check the availability, security or the configuration of the dialogue with the recipient party the diagnostic message has been designed to perform specific administrative tasks without relying on “dummy” messages an acceptordiagnosticresponse message is sent back by the recipientparty to the initiatingparty to confirm the availability of the recipientparty an acceptordiagnosticrequest message is used to confirm the identification of the partners of the exchanges ensure that security on both sides of the dialogue is synchronised test the communication with a recipientparty endorse the version of the configuration parameters if the acceptordiagnosticrequest message is received without errors by the recipient party, an acceptordiagnosticresponse message is sent back by the recipient party to the initiating party the recipient party uses an acceptordiagnosticresponse message to request the initiating party to notify the recipient party about any maintenance operations that may be required if the recipientparty receives an acceptordiagnosticrequest message with errors or cannot process the message, an acceptorrejection message is returned to the initiatingparty with the appropriate rejectreason request http parameters url /v1/caaa/diagnostic request http verb post request message use iso20022 message definition acceptor (message identifier caaa 013 001 010) it is recommended to use the iso 20022 dictionary to determine the complete structure of the message https //www iso20022 org/standardsrepository/type/acceptordiagnosticrequestv01 please note the following additional requirements property header of type header1 (child of acceptordiagnosticrequestv01 ) is mandatory property securitytrailer of type contentinformationtype3 (child of acceptordiagnosticrequestv01 ) is mandatory examples the messages provided below are formatted for readability when sending requests to the gateway, the request body should be compacted by removing all non significant whitespace characters example acceptor diagnostic request \<?xml version="1 0" encoding="utf 8"?> \<document xmlns\ xsi="http //www w3 org/2001/xmlschema instance" xmlns="urn\ iso\ std\ iso 20022\ tech\ xsd\ caaa 013 001 12"> \<accptrdgnstcreq> \<hdr> \<msgfctn>dgnp\</msgfctn> \<prtcolvrsn>9 0\</prtcolvrsn> \<xchgid>823779899142203\</xchgid> \<credttm>2025 10 20t11 34 53 661z\</credttm> \<initgpty> \<id>merch 42652191\</id> \<tp>merc\</tp> \<issr>acqr\</issr> \</initgpty> \<rcptpty> \<id>toro gateway\</id> \<tp>itag\</tp> \</rcptpty> \</hdr> \<dgnstcreq> \<envt> \<poi> \<id> \<id>poi 12345abcde\</id> \</id> \<cmpnt> \<tp>mdwr\</tp> \<subtpinf>toro android sdk\</subtpinf> \<id> \<prvdrid>ccs\</prvdrid> \</id> \<sts> \<vrsnnb>0 4 8\</vrsnnb> \</sts> \</cmpnt> \</poi> \</envt> \</dgnstcreq> \<sctytrlr> \<cntttp>auth\</cntttp> \<authntcddata> \<rcpt> \<keyidr> \<keyid>specv1testkey\</keyid> \<keyvrsn>1\</keyvrsn> \</keyidr> \</rcpt> \<macalgo> \<algo>cca3\</algo> \</macalgo> \<ncpsltdcntt> \<cntttp>data\</cntttp> \</ncpsltdcntt> \<mac>fw7vsjliplm41g4i7spxab==\</mac> \</authntcddata> \</sctytrlr> \</accptrdgnstcreq> \</document> example acceptor diagnostic response \<?xml version="1 0" encoding="utf 8"?> \<document xmlns\ none="urn\ iso\ std\ iso 20022\ tech\ xsd\ caaa 014 001 10" xmlns\ xsi="http //www w3 org/2001/xmlschema instance" xmlns="urn\ iso\ std\ iso 20022\ tech\ xsd\ caaa 014 001 10"> \<accptrdgnstcrspn> \<hdr> \<msgfctn>dgnq\</msgfctn> \<prtcolvrsn>9 0\</prtcolvrsn> \<xchgid>823779899142203\</xchgid> \<credttm>2025 10 22t15 48 47 410z\</credttm> \<initgpty> \<id>merch 42652191\</id> \<tp>merc\</tp> \<issr>acqr\</issr> \</initgpty> \<rcptpty> \<id>toro gateway\</id> \<tp>itag\</tp> \</rcptpty> \</hdr> \<dgnstcrspn> \<envt> \<poi> \<id> \<id>poi 12345abcde\</id> \</id> \<cmpnt> \<tp>mdwr\</tp> \<subtpinf>toro android sdk\</subtpinf> \<id> \<prvdrid>ccs\</prvdrid> \</id> \<sts> \<vrsnnb>0 4 8\</vrsnnb> \</sts> \</cmpnt> \</poi> \</envt> \</dgnstcrspn> \<sctytrlr> \<cntttp>auth\</cntttp> \<authntcddata> \<vrsn>0\</vrsn> \<rcpt> \<keyidr> \<keyid>specv1testkey\</keyid> \<keyvrsn>1\</keyvrsn> \</keyidr> \</rcpt> \<macalgo> \<algo>cca3\</algo> \</macalgo> \<ncpsltdcntt> \<cntttp>data\</cntttp> \</ncpsltdcntt> \<mac>0sop4tacbqbvcdef5zyy8a==\</mac> \</authntcddata> \</sctytrlr> \</accptrdgnstcrspn> \</document>