Dual Message Account Funding Transactions (AFTs) to Establish a Recurring Payout Transaction (CIT)

Account Funding Transactions allow a payment service provider to debit funds from a cardholder's Mastercard or Visa account to fund a non-merchant account. This is typically used to load funds onto prepaid cards and electronic wallets.
Dual Message Account Funding Transactions (AFTs) provide the following benefits:
  • Enables customers to identify Mastercard and Visa transactions during the authorization and settlement.
  • Allows acquiring partners to use Dual Message BINs when performing a payout transaction.
Using the credential-on-file transactions, customers can set up recurring transfers, for example transferring $50 to the customer's wallet each month. To set up such a transaction, the customer needs to create a Customer Inititated Transaction (CIT) that establishes the frequency, amount and duration of the recurring transfer. This information is then saved so that follow on Merchant Initiated Transactions (MITs) can occur on the customer's behalf.

Endpoint

Set the
ccAuthService_run
 field to
true
.
Send the request to
https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
.

Required Fields for a Dual-Message AFT with a CIT Request

These fields are required to process a dual-message AFT with a CIT request:
This field is only required when you have received an XID value in a previous transaction.
invoiceHeader_invoiceNumber
purchaseTotals_invoiceAmount

Simple Order Example: Dual-Message AFT with a CIT

Light Dark
Request
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
<-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header>
        <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <wsse:UsernameToken>
                <wsse:Username>en_vdcuruguay_1_ccs</wsse:Username>
                <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">ygx8jlKyl6nZlY67dH4kKo4VZm6T9j3wV2WNA1j+44NoCkFlrJFFkklShtTCSAKG5xCbiFPZJwvuNlEO9zokZUhOOYNvYcKza+XT+O2ZlYhJ6EfkCsmAuVtHqpCXfIVoTOszxh64maLeO5fX0+FoVRuduB+83X0+82iQP2B0ObYPykL2MPZtlFcz4JmM9JAJGYqvo2llkZHPrQrkhoDddKBs5gcWZwZ/VugdvYmdTLZg3f2afiAc8DlTUQ7lwqck5wkVgitkBSJe3ZuhviPTE8zRL31pI+MP4AmV5ujuR+SAHtGFew9rWye9OKpig5mKgMDA+3r0vUbbGiaWbfo1mA==</wsse:Password>
            </wsse:UsernameToken>
        </wsse:Security>
    </SOAP-ENV:Header>
    <SOAP-ENV:Body>
        <requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.221">
            <merchantID>en_vdcuruguay_1_ccs</merchantID>
            <merchantReferenceCode>TC55255-1</merchantReferenceCode>
            <invoiceHeader>
                <merchantDescriptor>John</merchantDescriptor>
                <merchantDescriptorStreet>cr avenue</merchantDescriptorStreet>
                <merchantDescriptorState>CA</merchantDescriptorState>
                <merchantVATRegistrationNumber>15426476537657</merchantVATRegistrationNumber>
                <businessApplicationID>WT</businessApplicationID>
                <invoiceNumber>13490</invoiceNumber>
            </invoiceHeader>
            <billTo>
                <firstName>JHON</firstName>
                <lastName>SMITH</lastName>
                <street1>1-26-28 Nakashirane,</street1>
                <street2>Asahi-ku</street2>
                <street3>Suite 500</street3>
                <city>Yokohama-shi</city>
                <state>CA</state>
                <postalCode>602-8511</postalCode>
                <country>US</country>
                <phoneNumber>999-123-9999</phoneNumber>
                <email>test@visa.com</email>
            </billTo>
            <purchaseTotals>
                <currency>USD</currency>
                <grandTotalAmount>500</grandTotalAmount>
                <invoiceAmount>1234</invoiceAmount>
            </purchaseTotals>
            <card>
                <accountNumber>4111111111111111</accountNumber>
                <expirationMonth>12</expirationMonth>
                <expirationYear>2030</expirationYear>
                <cvNumber>123</cvNumber>
                <cardType>001</cardType>
            </card>
            <ccAuthService run="true">
                <cavv>ABCDEabcde12345678900987654321abcdeABCDE</cavv>
                <networkTokenCryptogram>ABCDE12345ABCED12345ABCDE123</networkTokenCryptogram>
                <commerceIndicator>vbv</commerceIndicator>
                <xid>12345678909876543210ABCDEabcdeABCDEF1234</xid>
                <aggregatorName>Test</aggregatorName>
                <captureDate>1231</captureDate>
                <purposeOfPayment>16</purposeOfPayment>
                <initiatorType>s</initiatorType>
            </ccAuthService>
            <surchargeAmount>5</surchargeAmount>
            <surchargeSign>c</surchargeSign>
            <recipient>
                <postalCode>222120</postalCode>
                <accountID>987654321</accountID>
                <accountType>33</accountType>
                <lastName>recla</lastName>
                <firstName>recfirhgfhtfh</firstName>
                <middleName>recmiddle</middleName>
                <address>this is address1</address>
                <city>westb</city>
                <country>IN</country>
                <buildingNumber>266</buildingNumber>
                <address2>this is address2</address2>
                <streetName>colourful Street</streetName>
            </recipient>
            <sender>
                <referenceNumber>REFNUM123</referenceNumber>
                <sourceOfFunds>02</sourceOfFunds>
                <name>justsenderName</name>
                <address>addressofthesender</address>
                <city>blr</city>
                <state>ka</state>
                <country>India</country>
                <accountNumber>154264765376576126571652675176</accountNumber>
                <firstName>Sachin</firstName>
                <middleName>andy</middleName>
                <lastName>poov</lastName>
                <personalIDType>TXIN</personalIDType>
                <type>B</type>
                <identificationNumber>23506907642323235</identificationNumber>
            </sender>
            <aft>
                <indicator>true</indicator>
                <foreignExchangeFee>12</foreignExchangeFee>
            </aft>
            <subsequentAuthStoredCredential>false</subsequentAuthStoredCredential>
        </requestMessage>
    </SOAP-ENV:Body>
</SOAP-:Envelope>
Response
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
<?="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
        <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
            <wsu:Timestamp wsu:Id="TS-c3c104ec-1bae-4231-9d11-eb5e89c62bb8">
                <wsu:Created>2024-06-26T10:12:59.688Z</wsu:Created>
            </wsu:Timestamp>
        </wsse:Security>
    </soap:Header>
    <soap:Body>
        <c:replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.221">
            <c:merchantReferenceCode>TC55255-1</c:merchantReferenceCode>
            <c:requestID>7193967786057005809916</c:requestID>
            <c:decision>ACCEPT</c:decision>
            <c:reasonCode>100</c:reasonCode>
            <c:requestToken>Axj/7wSThfxbwiTbLED8AHgs3YuWbls3buGzBq3YMGrhg5csWybWNLU08AU2saWpp5pBDDUEFKGTb/7FxVPEOuBOThfxbwiTbLED8AAAyRo1</c:requestToken>
            <c:purchaseTotals>
                <c:currency>USD</c:currency>
            </c:purchaseTotals>
            <c:ccAuthReply>
                <c:reasonCode>100</c:reasonCode>
                <c:amount>500.00</c:amount>
                <c:authorizationCode>831000</c:authorizationCode>
                <c:avsCode>Y</c:avsCode>
                <c:avsCodeRaw>Y</c:avsCodeRaw>
                <c:cvCode>M</c:cvCode>
                <c:cvCodeRaw>M</c:cvCodeRaw>
                <c:authorizedDateTime>2024-06-26T10:12:59Z</c:authorizedDateTime>
                <c:processorResponse>00</c:processorResponse>
                <c:reconciliationID>7193967786057005809916</c:reconciliationID>
                <c:merchantAdviceCode>01</c:merchantAdviceCode>
                <c:merchantAdviceCodeRaw>M001</c:merchantAdviceCodeRaw>
                <c:cavvResponseCode>2</c:cavvResponseCode>
                <c:cavvResponseCodeRaw>2</c:cavvResponseCodeRaw>
                <c:paymentNetworkTransactionID>016153570198200</c:paymentNetworkTransactionID>
                <c:reconciliationReferenceNumber>417810816287</c:reconciliationReferenceNumber>
            </c:ccAuthReply>
            <c:receiptNumber>816287</c:receiptNumber>
            <c:additionalData>ABC</c:additionalData>
            <c:card>
                <c:cardType>001</c:cardType>
            </c:card>
            <c:reserved>
                <ics_message xmlns="urn:schemas-cybersource-com:transaction-data:ics">
                    <ics_decision_reason_code>100</ics_decision_reason_code>
                    <auth_payment_network_transaction_id>016153570198200</auth_payment_network_transaction_id>
                    <auth_rcode>1</auth_rcode>
                    <receipt_number>816287</receipt_number>
                    <ics_return_code>1000000</ics_return_code>
                    <auth_merchant_advice_code>01</auth_merchant_advice_code>
                    <ics_rcode>1</ics_rcode>
                    <auth_cavv_response_code>2</auth_cavv_response_code>
                    <auth_auth_response>00</auth_auth_response>
                    <auth_rmsg>Request was processed successfully.</auth_rmsg>
                    <merchant_ref_number>TC55255-1</merchant_ref_number>
                    <auth_merchant_advice_code_raw>M001</auth_merchant_advice_code_raw>
                    <currency>USD</currency>
                    <auth_auth_code>831000</auth_auth_code>
                    <auth_auth_amount>500.00</auth_auth_amount>
                    <auth_cv_result_raw>M</auth_cv_result_raw>
                    <auth_fee_program_indicator>123</auth_fee_program_indicator>
                    <card_type>001</card_type>
                    <auth_additional_token_response_information>0</auth_additional_token_response_information>
                    <ics_rmsg>Request was processed successfully.</ics_rmsg>
                    <auth_trans_ref_no>7193967786057005809916</auth_trans_ref_no>
                    <request_id>7193967786057005809916</request_id>
                    <auth.reason_code>100</auth.reason_code>
                    <auth_cavv_response_code_raw>2</auth_cavv_response_code_raw>
                    <auth_auth_time>2024-06-26T101259Z</auth_auth_time>
                    <auth_rflag>SOK</auth_rflag>
                    <auth_cv_result>M</auth_cv_result>
                    <auth_return_code>1010000</auth_return_code>
                    <auth_avs_raw>Y</auth_avs_raw>
                    <ics_rflag>SOK</ics_rflag>
                    <auth_reconciliation_reference_number>417810816287</auth_reconciliation_reference_number>
                    <auth_auth_avs>Y</auth_auth_avs>
                    <request_token>Axj/7wSThfxbwiTbLED8AHgs3YuWbls3buGzBq3YMGrhg5csWybWNLU08AU2saWpp5pBDDUEFKGTb/7FxVPEOuBOThfxbwiTbLED8AAAyRo1</request_token>
                    <additional_data>ABC</additional_data>
                </ics_message>
            </c:reserved>
            <c:additionalToken>
                <c:responseInformation>0</c:responseInformation>
            </c:additionalToken>
        </c:replyMessage>
    </soap:Body>
</:Envelope>