Completions

5 min

financial capture of an authorisation can be handled using the transactioncapture property of element cardpaymenttransaction124 in most scenarios this is the recommended approach alternatively, the dual message flow can be used an acceptorauthorisationrequest message is sent to request the approval of the transaction the transaction succeeds after the approval of the authorisation an acceptorcompletionadvice message is then sent to capture the transaction an acceptorcompletionadviceresponse message is sent back to the acceptor request http parameters url /v1/caaa/completion advice http verb post request message use iso20022 message definition acceptorcompletionadvicev12 (message identifier caaa 003 001 12) it is recommended to use the iso 20022 dictionary to determine the complete structure of the message https //www iso20022 org/standardsrepository/type/acceptorcompletionadvicev12 please note the following additional requirements property securitytrailer of type contentinformationtype36 (child of acceptorcompletionadvicev12 ) is mandatory property originaltransaction (child of acceptorcompletionadvicev12 ) is mandatory property salereferenceidentification (path accptrcmpltnadvc cmpltnadvc tx orgnltx salrefid ) is mandatory and must match the original value sent in the initial acceptorauthorisationrequest originaltransaction must also include the transactiontype property response message if the request could not be successfully processed, an acceptorrejection message will be returned otherewise, an acceptorcompletionadviceresponse message will be returned to inform the acceptor of the outcome of the request the acceptorcompletionadviceresponsev11 (message identifier caaa 004 001 11) will be used it is recommended to use the iso 20022 dictionary to determine the complete structure of the message https //www iso20022 org/standardsrepository/type/acceptorauthorisationrequestv12 please note that a securitytrailer of type contentinformationtype36 will always be included with the acceptorcompletionadviceresponse to allow the acceptor to verify that the response is legitimate examples the message 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 request \<?xml version="1 0" encoding="utf 8"?> \<document 	xmlns\ none="urn\ iso\ std\ iso 20022\ tech\ xsd\ caaa 003 001 09" 	xmlns\ xsi="http //www w3 org/2001/xmlschema instance" 	xmlns="urn\ iso\ std\ iso 20022\ tech\ xsd\ caaa 003 001 09"> 	\<accptrcmpltnadvc> 	 \<hdr> 	 \<msgfctn>fcmv\</msgfctn> 	 \<prtcolvrsn>12 0\</prtcolvrsn> 	 \<xchgid>150\</xchgid> 	 \<credttm>2021 04 20t17 17 17 602118+01 00\</credttm> 	 \<initgpty> 	 \<id>66000001\</id> 	 \<tp>opoi\</tp> 	 \<issr>acqr\</issr> 	 \</initgpty> 	 \<rcptpty> 	 \<id>epas acquirer 1\</id> 	 \<tp>acqr\</tp> 	 \</rcptpty> 	 \</hdr> 	 \<cmpltnadvc> 	 \<envt> 	 \<acqrr> 	 \<id> 	 \<id>9287351\</id> 	 \<tp>acqr\</tp> 	 \</id> 	 \<paramsvrsn>2020 06 24 17 27 17\</paramsvrsn> 	 \</acqrr> 	 \<mrchnt> 	 \<id> 	 \<id>epasmer001\</id> 	 \</id> 	 \<cmonnm>epasorg merchant 1\</cmonnm> 	 \<lctnctgy>fixd\</lctnctgy> 	 \<lctnandctct> 	 \<pstladr> 	 \<twnnm>paris\</twnnm> 	 \<ctrycd>fr\</ctrycd> 	 \</pstladr> 	 \</lctnandctct> 	 \</mrchnt> 	 \<poi> 	 \<id> 	 \<id>1\</id> 	 \<issr>acqr\</issr> 	 \</id> 	 \<sysnm>poi01\</sysnm> 	 \<cpblties> 	 \<cardrdngcpblties>cicc\</cardrdngcpblties> 	 \<cardrdngcpblties>mgst\</cardrdngcpblties> 	 \<cardrdngcpblties>phys\</cardrdngcpblties> 	 \<crdhldrvrfctncpblties>mnsg\</crdhldrvrfctncpblties> 	 \<crdhldrvrfctncpblties>fcpn\</crdhldrvrfctncpblties> 	 \<crdhldrvrfctncpblties>fepn\</crdhldrvrfctncpblties> 	 \<crdhldrvrfctncpblties>npin\</crdhldrvrfctncpblties> 	 \<onlinecpblties>smon\</onlinecpblties> 	 \<msgcpblties> 	 \<dstn>cdsp\</dstn> 	 \<nboflines>2\</nboflines> 	 \<linewidth>20\</linewidth> 	 \</msgcpblties> 	 \<msgcpblties> 	 \<dstn>mrcp\</dstn> 	 \<nboflines>2\</nboflines> 	 \<linewidth>40\</linewidth> 	 \</msgcpblties> 	 \</cpblties> 	 \<cmpnt> 	 \<tp>term\</tp> 	 \<id> 	 \<itmnb>1\</itmnb> 	 \<prvdrid>epasvendor001\</prvdrid> 	 \<id>smartpoi 8539\</id> 	 \<srlnb>7825410759\</srlnb> 	 \</id> 	 \</cmpnt> 	 \<cmpnt> 	 \<tp>apli\</tp> 	 \<id> 	 \<itmnb>1\</itmnb> 	 \<prvdrid>epasvendor001\</prvdrid> 	 \</id> 	 \<sts> 	 \<vrsnnb>1 0\</vrsnnb> 	 \</sts> 	 \<stdcmplc> 	 \<id>sepa fast\</id> 	 \<vrsn>3 0\</vrsn> 	 \<issr>cir\</issr> 	 \</stdcmplc> 	 \</cmpnt> 	 \</poi> 	 \<card> 	 \<prtctdcarddata> 	 \<cntttp>evlp\</cntttp> 	 \<envlpddata> 	 \<rcpt> 	 \<kek> 	 \<kekid> 	 \<keyid>specv1testkey\</keyid> 	 \<keyvrsn>2010060715\</keyvrsn> 	 \<derivtnid>oyclpqe=\</derivtnid> 	 \</kekid> 	 \<keyncrptnalgo> 	 \<algo>dkp9\</algo> 	 \</keyncrptnalgo> 	 \<ncrptdkey>4pagabc=\</ncrptdkey> 	 \</kek> 	 \</rcpt> 	 \<ncrptdcntt> 	 \<cntttp>data\</cntttp> 	 \<cnttncrptnalgo> 	 \<algo>e3dc\</algo> 	 \<param> 	 \<initlstnvctr>onu0brwwbgk=\</initlstnvctr> 	 \</param> 	 \</cnttncrptnalgo> 	 \<ncrptddata>y4vi8vnjpe3pcy4l8yxodpla1avuab/p6vt8v8ejmf++uqdgrdqvdi6pr9jkmbqtf98wo/khtlxmmn7ocmmkriobrno/3gxsk3gzjhlmxiyzuzcrezrmjgmwj929v+jbcp4yddgw0tstnfi2u0pkmfxuokb0zjp95uqdwkm6xpsz58x+ruzk49h7xrlperr5+a8bjcfcdftwqej3x2erodc9hmknwhqrza/4eh8vbbtjrle0scncwoknknub4nyd4o5n2sqpotm=\</ncrptddata> 	 \</ncrptdcntt> 	 \</envlpddata> 	 \</prtctdcarddata> 	 \<cardctrycd>056\</cardctrycd> 	 \<cardpdctprfl>0003\</cardpdctprfl> 	 \<cardbrnd>testcard\</cardbrnd> 	 \</card> 	 \<crdhldr> 	 \<lang>fr\</lang> 	 \<txvrfctnrslt> 	 \<mtd>fpin\</mtd> 	 \<vrfctnntty>iccd\</vrfctnntty> 	 \<rslt>succ\</rslt> 	 \</txvrfctnrslt> 	 \</crdhldr> 	 \</envt> 	 \<cntxt> 	 \<pmtcntxt> 	 \<cardpres>true\</cardpres> 	 \<crdhldrpres>true\</crdhldrpres> 	 \<attndnccntxt>attd\</attndnccntxt> 	 \<attndntmsgcpbl>true\</attndntmsgcpbl> 	 \<attndntlang>fr\</attndntlang> 	 \<carddatantrymd>cicc\</carddatantrymd> 	 \</pmtcntxt> 	 \<salecntxt> 	 \<saleid>st06\</saleid> 	 \<salerefnb>s78 t06 0029\</salerefnb> 	 \<salercncltnid>s78 8469\</salercncltnid> 	 \</salecntxt> 	 \</cntxt> 	 \<tx> 	 \<txcaptr>true\</txcaptr> 	 \<txtp>crdp\</txtp> 	 \<mrchntctgycd>5411\</mrchntctgycd> 	 \<txid> 	 \<txdttm>2021 04 20t17 17 17 263994+01 00\</txdttm> 	 \<txref>002949\</txref> 	 \</txid> 	 \<txsucss>true\</txsucss> 	 \<rcncltnid>8469\</rcncltnid> 	 \<txdtls> 	 \<ccy>eur\</ccy> 	 \<ttlamt>43 14\</ttlamt> 	 \<iccrltddata>xyoccxhfnaeaggj8aiqhoaaaaak1eiocmdcrcntll8wdat4qabkvbqaaaiaamgmrbbgcaqcfagyaaaaaqxsfcqiaap8qegiqz4adbaaanyeaaaaaaaaa/58aagjqnyyikao8iorh6ayfjwfanzmdykbanzqdramcnzubip82agawnzcevhxps59abaaakpabn0winygwlg7qxfq=\</iccrltddata> 	 \</txdtls> 	 \<authstnrslt> 	 \<authstnntty> 	 \<tp>ciss\</tp> 	 \</authstnntty> 	 \<rspntoauthstn> 	 \<rspn>appr\</rspn> 	 \</rspntoauthstn> 	 \<authstncd>032983\</authstncd> 	 \</authstnrslt> 	 \<txvrfctnrslt> 	 \<mtd>fpin\</mtd> 	 \<vrfctnntty>iccd\</vrfctnntty> 	 \<rslt>succ\</rslt> 	 \</txvrfctnrslt> 	 \</tx> 	 \</cmpltnadvc> 	 \<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>9xiobnj/pyab10eb4l6n4w==\</mac> 	 \</authntcddata> 	 \</sctytrlr> 	\</accptrcmpltnadvc> \</document> example response \<?xml version="1 0" encoding="utf 8"?> \<document 	xmlns\ none="urn\ iso\ std\ iso 20022\ tech\ xsd\ caaa 004 001 08" 	xmlns\ xsi="http //www w3 org/2001/xmlschema instance" 	xmlns="urn\ iso\ std\ iso 20022\ tech\ xsd\ caaa 004 001 08"> 	\<accptrcmpltnadvcrspn> 	 \<hdr> 	 \<msgfctn>fcmk\</msgfctn> 	 \<prtcolvrsn>9 0\</prtcolvrsn> 	 \<xchgid>150\</xchgid> 	 \<credttm>2021 04 20t17 17 17 745174+01 00\</credttm> 	 \<initgpty> 	 \<id>66000001\</id> 	 \<tp>opoi\</tp> 	 \<issr>acqr\</issr> 	 \</initgpty> 	 \<rcptpty> 	 \<id>epas acquirer 1\</id> 	 \<tp>acqr\</tp> 	 \</rcptpty> 	 \</hdr> 	 \<cmpltnadvcrspn> 	 \<envt> 	 \<acqrr> 	 \<id> 	 \<id>9287351\</id> 	 \<tp>acqr\</tp> 	 \</id> 	 \<paramsvrsn>2020 06 24 17 27 17\</paramsvrsn> 	 \</acqrr> 	 \<mrchnt> 	 \<id> 	 \<id>epasmer001\</id> 	 \</id> 	 \<cmonnm>epasorg merchant 1\</cmonnm> 	 \<lctnctgy>fixd\</lctnctgy> 	 \<lctnandctct> 	 \<pstladr> 	 \<twnnm>paris\</twnnm> 	 \<ctrycd>fr\</ctrycd> 	 \</pstladr> 	 \</lctnandctct> 	 \</mrchnt> 	 \<poi> 	 \<id> 	 \<id>1\</id> 	 \<issr>acqr\</issr> 	 \</id> 	 \<sysnm>poi01\</sysnm> 	 \<cpblties> 	 \<cardrdngcpblties>cicc\</cardrdngcpblties> 	 \<cardrdngcpblties>mgst\</cardrdngcpblties> 	 \<cardrdngcpblties>phys\</cardrdngcpblties> 	 \<crdhldrvrfctncpblties>mnsg\</crdhldrvrfctncpblties> 	 \<crdhldrvrfctncpblties>fcpn\</crdhldrvrfctncpblties> 	 \<crdhldrvrfctncpblties>fepn\</crdhldrvrfctncpblties> 	 \<crdhldrvrfctncpblties>npin\</crdhldrvrfctncpblties> 	 \<onlinecpblties>smon\</onlinecpblties> 	 \<msgcpblties> 	 \<dstn>cdsp\</dstn> 	 \<nboflines>2\</nboflines> 	 \<linewidth>20\</linewidth> 	 \</msgcpblties> 	 \<msgcpblties> 	 \<dstn>mrcp\</dstn> 	 \<nboflines>2\</nboflines> 	 \<linewidth>40\</linewidth> 	 \</msgcpblties> 	 \</cpblties> 	 \<cmpnt> 	 \<tp>term\</tp> 	 \<id> 	 \<itmnb>1\</itmnb> 	 \<prvdrid>epasvendor001\</prvdrid> 	 \<id>smartpoi 8539\</id> 	 \<srlnb>7825410759\</srlnb> 	 \</id> 	 \</cmpnt> 	 \<cmpnt> 	 \<tp>apli\</tp> 	 \<id> 	 \<itmnb>1\</itmnb> 	 \<prvdrid>epasvendor001\</prvdrid> 	 \</id> 	 \<sts> 	 \<vrsnnb>1 0\</vrsnnb> 	 \</sts> 	 \<stdcmplc> 	 \<id>sepa fast\</id> 	 \<vrsn>3 0\</vrsn> 	 \<issr>cir\</issr> 	 \</stdcmplc> 	 \</cmpnt> 	 \</poi> 	 \<card> 	 \<prtctdcarddata> 	 \<cntttp>evlp\</cntttp> 	 \<envlpddata> 	 \<rcpt> 	 \<kek> 	 \<kekid> 	 \<keyid>specv1testkey\</keyid> 	 \<keyvrsn>2010060715\</keyvrsn> 	 \<derivtnid>oyclpqe=\</derivtnid> 	 \</kekid> 	 \<keyncrptnalgo> 	 \<algo>dkp9\</algo> 	 \</keyncrptnalgo> 	 \<ncrptdkey>4pagabc=\</ncrptdkey> 	 \</kek> 	 \</rcpt> 	 \<ncrptdcntt> 	 \<cntttp>data\</cntttp> 	 \<cnttncrptnalgo> 	 \<algo>e3dc\</algo> 	 \<param> 	 \<initlstnvctr>onu0brwwbgk=\</initlstnvctr> 	 \</param> 	 \</cnttncrptnalgo> 	 \<ncrptddata>y4vi8vnjpe3pcy4l8yxodpla1avuab/p6vt8v8ejmf++uqdgrdqvdi6pr9jkmb qtf98wo/khtlxmmn7ocmmkriobrno/3gxsk3gzjhlmxiyzuzcrezrmjgmwj929v+jbcp4yddgw 0tstnfi2u0pkmfxuokb0zjp95uqdwkm6xpsz58x+ruzk49h7xrlperr5+a8bjcfcdftwqej3x2 erodc9hmknwhqrza/4eh8vbbtjrle0scncwoknknub4nyd4o5n2sqpotm=\</ncrptddata> 	 \</ncrptdcntt> 	 \</envlpddata> 	 \</prtctdcarddata> 	 \<cardctrycd>056\</cardctrycd> 	 \<cardpdctprfl>0003\</cardpdctprfl> 	 \<cardbrnd>testcard\</cardbrnd> 	 \</card> 	 \<crdhldr> 	 \<lang>fr\</lang> 	 \<txvrfctnrslt> 	 \<mtd>fpin\</mtd> 	 \<vrfctnntty>iccd\</vrfctnntty> 	 \<rslt>succ\</rslt> 	 \</txvrfctnrslt> 	 \</crdhldr> 	 \</envt> 	 \<tx> 	 \<txid> 	 \<txdttm>2021 04 20t17 17 17 263994+01 00\</txdttm> 	 \<txref>002949\</txref> 	 \</txid> 	 \<rspn>appr\</rspn> 	 \</tx> 	 \</cmpltnadvcrspn> 	 \<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>9xiobnj/pyab10eb4l6n4w==\</mac> 	 \</authntcddata> 	 \</sctytrlr> 	\</accptrcmpltnadvcrspn> \</document>