logo Mercanet

Release 24.5

go directly to content

Search by keywords

cardOrder (batch)

To search in the page use Ctrl+F on your keyboard

Requests for payment orders via card include the bellow elements.

Required

Optional

Request sample

            FILE;request;office;v19
HEADER;023101122334455;2021-12-16+0100;14:26:45+0100;1
CARDORDER;6;023101122334456;SIM20220329092501;66;8;AUTHOR_CAPTURE;987;20210328;20210329;1234567890123456;44;978;customer@email.com;customerId;128.0.0.1;2022-03-29T09:30:16+02:00;INTERNET;orderId;ONE_SHOT;returnContext;statementReference;origin;Y;ctrl1;info1;USA;POR;ITA;SPA;BRA;FIN;GER;CHI;PAN;accordSettlementMode;settlementMode;initialCavv;merchantAuthentMethod;19960130;101;20210329;VISA;paymentMeanBrandSelectionStatus;initialSchemeTransactionIdentifier;settlementArchivingReference;settlementMerchantSpecificData;invoiceReference;023101122334457;subMerchantCategoryCode;subMerchantLegalId;subMerchantName;Paris;FRA;Rue de la Rgent;5;75000;additional1;additional2;additional3;postbox;IleDeFrance;subMerchantUrl.com
END;1

        
            <?xml version="1.0" encoding="UTF-8"?>
<file format="office" type="request" version="5">
	<header>
		<remitterId>023101122334455</remitterId>
		<date>2018-07-25+02:00</date>
		<time>09:00:00+01:00</time>
		<sequence>1</sequence>
	</header>
	<body>
		<cardOrder recordSequence="1">
            <merchantId>023101122334456</merchantId>
            <transactionReference>SIM20220329092501</transactionReference>
            <amount>66</amount>
            <captureDay>8</captureDay>
            <captureMode>AUTHOR_CAPTURE</captureMode>
            <cardCSCValue>987</cardCSCValue>
            <cardEffectiveDate>20210328</cardEffectiveDate>
            <cardExpiryDate>20210329</cardExpiryDate>
            <cardNumber>1234567890123456</cardNumber>
            <currencyCode>978</currencyCode>
            <customerEmail>customer@email.com</customerEmail>
            <customerId>customerId</customerId>
            <customerIpAddress>128.0.0.1</customerIpAddress>
            <merchantTransactionDateTime>2022-03-29T09:30:16+02:00</merchantTransactionDateTime>
            <orderChannel>INTERNET</orderChannel>
            <orderId>orderId</orderId>
            <paymentPattern>ONE_SHOT</paymentPattern>
            <returnContext>returnContext</returnContext>
            <statementReference>statementReference</statementReference>
            <transactionOrigin>origin</transactionOrigin>
            <fraudData>
                <bypass3DS>Y</bypass3DS>
                <bypassCtrlList>
                    <ctrl>ctrl1</ctrl>
                </bypassCtrlList>
                <bypassInfoList>
                    <info>info1</info>
                </bypassInfoList>
                <allowedCardCountryList>
                    <country>USA</country>
                </allowedCardCountryList>
                <deniedCardCountryList>
                    <country>POR</country>
                </deniedCardCountryList>
                <allowedCardArea>ITA</allowedCardArea>
                <deniedCardArea>SPA</deniedCardArea>
                <allowedIpCountryList>
                    <country>BRA</country>
                </allowedIpCountryList>
                <deniedIpCountryList>
                    <country>FIN</country>
                </deniedIpCountryList>
                <allowedIpArea>GER</allowedIpArea>
                <deniedIpArea>CHI</deniedIpArea>
                <riskManagementDynamicSettingList>
                    <riskManagementDynamicSetting>
                        <riskManagementDynamicParam>param1</riskManagementDynamicParam>
                        <riskManagementDynamicValue>value1</riskManagementDynamicValue>
                    </riskManagementDynamicSetting>
                </riskManagementDynamicSettingList>
            </fraudData>
            <panType>PAN</panType>
            <paymentMeanData>
                <cofinoga>
                    <settlementMode>settlementMode</settlementMode>
                </cofinoga>
                <bancontact>
                    <initialAuthenticationCavv>initialCavv</initialAuthenticationCavv>
                    <bancontactMerchantCustomerAuthenticationMethod>merchantAuthentMethod</bancontactMerchantCustomerAuthenticationMethod>
                </bancontact>
            </paymentMeanData>
            <holderData>
                <birthDate>19960130</birthDate>
            </holderData>
            <s10TransactionReference>
                <s10TransactionId>101</s10TransactionId>
                <s10TransactionIdDate>20210329</s10TransactionIdDate>
            </s10TransactionReference>
            <riskManagementCustomDataList>
                <riskManagementCustomData>
                    <riskManagementCustomSequence>sequence</riskManagementCustomSequence>
                    <riskManagementCustomValue>value</riskManagementCustomValue>
                </riskManagementCustomData>
            </riskManagementCustomDataList>
            <shoppingCartDetail>
                <shoppingCartTotalAmount>66</shoppingCartTotalAmount>
                <shoppingCartTotalQuantity>1</shoppingCartTotalQuantity>
                <shoppingCartTotalTaxAmount>2</shoppingCartTotalTaxAmount>
                <mainProduct>main</mainProduct>
                <ShoppingCartItemList>
                    <shoppingCartItem>
                        <productName>name</productName>
                        <productDescription>description</productDescription>
                        <productCode>code</productCode>
                        <productSKU>sku</productSKU>
                        <productUnitAmount>66</productUnitAmount>
                        <productQuantity>1</productQuantity>
                        <productTaxRate>01</productTaxRate>
                        <productUnitTaxAmount>2</productUnitTaxAmount>
                        <productCategory>category</productCategory>
                        <productTaxCategory>tax</productTaxCategory>
                        <travelData>
                            <numberOfTravelers>3</numberOfTravelers>
                            <travelStartDateTime>2021-03-27</travelStartDateTime>
                            <travelEndDateTime>2021-03-28</travelEndDateTime>
                            <travelReason>reason</travelReason>
                            <travelCardPeriod>period</travelCardPeriod>
                            <travelCardType>cardtype</travelCardType>
                            <PassportDataList>
                                <passportData>
                                    <passportExpirationDate>20210322</passportExpirationDate>
                                    <passportIssueCountry>POL</passportIssueCountry>
                                </passportData>
                            </PassportDataList>
                            <StayDataList>
                                <stayData>
                                    <stayLocation>stayLocation</stayLocation>
                                    <stayArrivalDateTime>2021-03-24</stayArrivalDateTime>
                                    <stayDepartureDateTime>2021-03-23</stayDepartureDateTime>
                                    <numberOfNights>8</numberOfNights>
                                    <numberOfPeopleStaying>9</numberOfPeopleStaying>
                                    <roomServiceLevel>roomServiceLevel</roomServiceLevel>
                                    <stayNumberOfRooms>10</stayNumberOfRooms>
                                    <stayCategory>stayCategory</stayCategory>
                                    <stayCompany>stayCompany</stayCompany>
                                    <stayInsurance>stayInsurance</stayInsurance>
                                    <stayInsuranceIndicator>true</stayInsuranceIndicator>
                                    <stayRentalCarIndicator>true</stayRentalCarIndicator>
                                </stayData>
                            </StayDataList>
                            <JourneyDataList>
                                <journeyData>
                                    <departureLocation>Brazilia</departureLocation>
                                    <arrivalLocation>Sao Polo</arrivalLocation>
                                    <destinationCountry>SRI</destinationCountry>
                                    <departureDateTime>2021-03-26</departureDateTime>
                                    <numberOfTickets>7</numberOfTickets>
                                    <ticketIssuerName>issuerName</ticketIssuerName>
                                    <ticketReference>ticketReference</ticketReference>
                                    <ticketIssueCity>La Paz</ticketIssueCity>
                                    <ticketIssueDate>20210325</ticketIssueDate>
                                    <fareBasis>fareBasis</fareBasis>
                                    <carrierIdentifier>carrierId</carrierIdentifier>
                                    <carrierName>carrierName</carrierName>
                                    <classLevel>class</classLevel>
                                    <journeyModality>modality</journeyModality>
                                    <journeyMode>mode</journeyMode>
                                    <journeyStage>stage</journeyStage>
                                    <journeySequence>sequ</journeySequence>
                                    <journeyInsurance>insurance</journeyInsurance>
                                    <journeyInsuranceIndicator>true</journeyInsuranceIndicator>
                                    <journeyCancellableIndicator>true</journeyCancellableIndicator>
                                    <luggageSupplementIndicator>true</luggageSupplementIndicator>
                                    <ticketExchangeabilityIndicator>true</ticketExchangeabilityIndicator>
                                    <journeyAmount>777</journeyAmount>
                                    <journeyNature>nature</journeyNature>
                                </journeyData>
                            </JourneyDataList>
                            <travelingPayerIndicator>true</travelingPayerIndicator>
                            <bookingData>
                                <bookingPlatform>platform</bookingPlatform>
                                <bookingPlatformOrderId>platformOrderId</bookingPlatformOrderId>
                                <bookingId>bookingId</bookingId>
                                <bookerFirstName>Melody</bookerFirstName>
                                <bookerLastName>Pond</bookerLastName>
                            </bookingData>
                        </travelData>
                    </shoppingCartItem>
                </ShoppingCartItemList>
            </shoppingCartDetail>
            <paymentMeanBrand>VISA</paymentMeanBrand>
            <paymentMeanBrandSelectionStatus>paymentMeanBrandSelectionStatus</paymentMeanBrandSelectionStatus>
            <initialSchemeTransactionIdentifier>initialSchemeTransactionIdentifier</initialSchemeTransactionIdentifier>
            <settlementArchivingReference>settlementArchivingReference</settlementArchivingReference>
            <settlementMerchantSpecificData>settlementMerchantSpecificData</settlementMerchantSpecificData>
            <orderContext>
                <customerHostName>hostName</customerHostName>
                <customerBrowserType>browser</customerBrowserType>
                <customerANI>ani</customerANI>
                <customerANIInformationIdentifier>aniId</customerANIInformationIdentifier>
                <merchantOrderSpecificDataList>
                    <merchantOrderSpecificData>
                        <merchantOrderSpecificDataReference>orderReference</merchantOrderSpecificDataReference>
                        <merchantOrderSpecificDataType>orderDataType</merchantOrderSpecificDataType>
                        <merchantOrderSpecificDataValue>orderDataValue</merchantOrderSpecificDataValue>
                    </merchantOrderSpecificData>
                </merchantOrderSpecificDataList>
            </orderContext>
            <travelContext>
                <departureDate>20210320</departureDate>
                <passengerName>passengerName</passengerName>
                <originAirport>originAirport</originAirport>
                <numberOfRoutingCities>22</numberOfRoutingCities>
                <routingCityList>
                    <routingCity>Beijing</routingCity>
                </routingCityList>
                <numberOfAirlineCarriers>20</numberOfAirlineCarriers>
                <airlineCarrierList>
                    <airlineCarrier>carrier</airlineCarrier>
                </airlineCarrierList>
                <fareBasis>fareBasis</fareBasis>
                <numberOfPassengers>21</numberOfPassengers>
                <destinationAirport>destinationAirport</destinationAirport>
                <reservationCode>reservationCode</reservationCode>
            </travelContext>
            <deliveryContact>
                <firstName>River</firstName>
                <lastName>Song</lastName>
                <gender>F</gender>
                <phone>0203040506</phone>
                <email>river.song.1@dw.net</email>
                <mobile>0607080910</mobile>
                <title>title</title>
                <initials>MP</initials>
            </deliveryContact>
            <deliveryAddress>
                <city>Paris</city>
                <country>FRA</country>
                <streetName>Rue de la Rgent</streetName>
                <streetNumber>1</streetNumber>
                <zipCode>75000</zipCode>
                <addressAdditional1>additional1</addressAdditional1>
                <addressAdditional2>additional2</addressAdditional2>
                <addressAdditional3>additional3</addressAdditional3>
                <postbox>postbox</postbox>
                <state>IleDeFrance</state>
            </deliveryAddress>
            <deliveryData>
                <deliveryMethod>deliveryMethod</deliveryMethod>
            </deliveryData>
            <holderContact>
                <firstName>River</firstName>
                <lastName>Song</lastName>
                <gender>F</gender>
                <phone>0203040506</phone>
                <email>river.song.2@dw.net</email>
                <mobile>0607080910</mobile>
                <title>title</title>
                <initials>MP</initials>
            </holderContact>
            <billingContact>
                <firstName>River</firstName>
                <lastName>Song</lastName>
                <gender>F</gender>
                <phone>0203040506</phone>
                <email>river.song.3@dw.net</email>
                <mobile>0607080910</mobile>
                <title>title</title>
                <initials>MP</initials>
            </billingContact>
            <billingAddress>
                <city>Paris</city>
                <country>FRA</country>
                <streetName>Rue de la Rgent</streetName>
                <streetNumber>2</streetNumber>
                <zipCode>75000</zipCode>
                <addressAdditional1>additional1</addressAdditional1>
                <addressAdditional2>additional2</addressAdditional2>
                <addressAdditional3>additional3</addressAdditional3>
                <postbox>postbox</postbox>
                <state>IleDeFrance</state>
            </billingAddress>
            <authenticationData>
                <cardAuthPolicy>
                    <checkAVS>checkAVS</checkAVS>
                    <ignoreCSCCheckResult>ignoreCSC</ignoreCSCCheckResult>
                    <ignorePostcodeCheckResult>ignorePostcode</ignorePostcodeCheckResult>
                    <ignoreAddressCheckResult>ignoreAddress</ignoreAddressCheckResult>
                    <automaticReverse>automaticReverse</automaticReverse>
                </cardAuthPolicy>
            </authenticationData>
            <holderAddress>
                <city>Paris</city>
                <country>FRA</country>
                <streetName>Rue de la Rgent</streetName>
                <streetNumber>3</streetNumber>
                <zipCode>75000</zipCode>
                <addressAdditional1>additional1</addressAdditional1>
                <addressAdditional2>additional2</addressAdditional2>
                <addressAdditional3>additional3</addressAdditional3>
                <postbox>postbox</postbox>
                <state>IleDeFrance</state>
            </holderAddress>
            <invoiceReference>invoiceReference</invoiceReference>
            <customerContact>
                <firstName>River</firstName>
                <lastName>Song</lastName>
                <gender>F</gender>
                <phone>0203040506</phone>
                <email>river.song.4@dw.net</email>
                <mobile>0607080910</mobile>
                <title>title</title>
                <initials>MP</initials>
            </customerContact>
            <subMerchantId>023101122334457</subMerchantId>
            <subMerchantCategoryCode>subMerchantCategoryCode</subMerchantCategoryCode>
            <subMerchantLegalId>subMerchantLegalId</subMerchantLegalId>
            <subMerchantName>subMerchantName</subMerchantName>
            <subMerchantAddress>
                <city>Paris</city>
                <country>FRA</country>
                <streetName>Rue de la Rgent</streetName>
                <streetNumber>5</streetNumber>
                <zipCode>75000</zipCode>
                <addressAdditional1>additional1</addressAdditional1>
                <addressAdditional2>additional2</addressAdditional2>
                <addressAdditional3>additional3</addressAdditional3>
                <postbox>postbox</postbox>
                <state>IleDeFrance</state>
            </subMerchantAddress>
            <subMerchantUrl>subMerchantUrl.com</subMerchantUrl>
        </cardOrder>
	</body>
	<end nbRecord="1" />
</file>

        

Required

  • amount
    presence
    Required
    Interface version
    4
    Order
    4

    Transaction amount. The amount must be transmitted in the smallest currency unit.For example in euros: an amount of EUR 10.50 must be transmitted in the form 1050.

  • currencyCode
    presence
    Required
    Interface version
    4
    Order
    7

    Currency code for the transaction. This code is ISO 4217 compatible.

    List of values
    032
    Argentinean Peso
    036
    Australian Dollar
    048
    Bahrain Dinar
    116
    Cambodian Riel
    124
    Canadian Dollar
    144
    Sri Lanka Rupee
    156
    China Yuan Renminbi
    191
    Croatia Kuna
    203
    Czech Republic Koruna
    208
    Danes crown
    344
    Hong Kong dollar
    348
    Hungary Forint
    352
    Iceland Rupee
    356
    Indian rupee
    376
    Israel Shekel
    392
    Japanese Yen
    410
    South Korean Won
    414
    Kuwait Dinar
    458
    Malaysia Ringgit
    480
    Mauritius Rupee
    484
    Mexican Peso
    524
    Nepal Rupee
    554
    New Zealand Dollar
    578
    Norwegian crown
    634
    Qatar Riyal
    643
    Russia Ruble
    682
    Saudi Arabia Riyal
    702
    Singapore Dollar
    710
    South Africa Rand
    752
    Swedish crown
    756
    Swiss Franc
    764
    Thailand Baht
    784
    United Arab Emirates Dirham
    788
    Tunisia Dinar
    826
    Pound
    840
    American Dollar
    901
    Taiwan Dollar
    941
    Serbian Dinar
    946
    Roumania New Leu
    949
    New Turkish Lira
    952
    CFA Franc
    953
    CFP Franc
    975
    Bulgaria Lev
    978
    Euro
    980
    Ukraine Hryvnia
    985
    Poland Zloty
    986
    Brazilian Real
  • merchantId
    presence
    Required
    Interface version
    4
    Order
    2

    Identifier of the shop, this value is provided to the merchant by Mercanet during the shop registration.

  • officeBatchResponseCode
    presence
    Required
    Interface version
    4
    Order
    31

    officeBatchResponseCode completes the result of the processing of a payment request handled by which would be rejected (classic reject responseCode) and contains the field of the payment request that is in error.

    List of values
    00
    None (all fields are correct)
    01
    merchantId error
    03
    transactionReference error
    04
    merchantTransactionDateTime error
    05
    amount error
    06
    captureDay error
    07
    captureMode error
    08
    operationAmount error
    09
    operationOrigin error
    11
    currencyCode error
    12
    customerIpAddress error
    13
    customerEmail error
    14
    customerId error
    16
    orderId error
    17
    orderChannel error
    18
    transactionOrigin error
    19
    returnContext error
    20
    fromTransactionReference error
    21
    cardExpiryDate error
    22
    cardNumber error
    23
    cardCSCValue error
    24
    cardEffectiveDate error
    25
    cardSeqNumber error
    26
    paymentMeanBrand error
    27
    authorisationId error
    28
    merchantWalletId error
    29
    paymentMeanId error
    30
    paymentPattern error
    31
    number error
    32
    statementReference error
    33
    panType error
    34
    mandateId error
    35
    valueDate error
    36
    paymentMeanAlias error
    37
    account error
    38
    bankCode error
    39
    transactionActors error
    45
    Date fields format error
    46
    settlementMode error
    47
    comment error
    48
    validationIndicator error
    50
    s10TransactionId error
    51
    s10TransactionIdDate error
    52
    s10FromTransactionId error
    53
    s10FromTransactionIdDate error
    54
    fraudData error
    55
    riskManagementDynamicParam error
    56
    riskManagementDynamicValue error
    57
    riskManagementDynamicSettingList error
    58
    fraudListReason error
    59
    fraudListType error
    60
    fraudListLevel error
    61
    fraudListElementType error
    62
    fraudListElementValue error
    63
    lastRecoveryIndicator error
    64
    orderContext error
    65
    travelContext error
    66
    deliveryData error
    67
    address error
    68
    contact error
    69
    cardAuthPolicy error
    70
    shoppingCartDetail error
    71
    merchantExternalId error
    72
    paymentMeansBrandSelectionStatus error
    73
    settlementArchivingReference error
    74
    settlementMerchantSpecificData error
    75
    fromTransactionAcceptor error
    80
    Merchant not registered to use Office Batch / Merchant not linked to the remitter declared in the header.
  • orderChannel
    presence
    Required
    Interface version
    4
    Order
    12

    Order channel used (Internet, Telephone, Post, Fax etc), Internet is the default value.Use of this field should be reconciled with the conditions defined in the acquirer contract.

    List of values
    FAX
    Fax order channel Acquiring contract: MOTO
    INAPP
    Order from a service inside an application (eg mobile) Acquiring contract: INTERNET
    INTERNET
    Internet order channel Acquiring contract: INTERNET
    IVR
    IVR order channel Acquiring contract: MOTO
    MAIL_ORDER
    Mail order channel Acquiring contract: MOTO
    MINITEL
    Obsolete
    MOTO
    Mail order or Telephone order channel without distinction (deprecated, use MAIL_ORDER or TELEPHONE_ORDER) Acquiring contract: MOTO
    PROXI_ATTENDED
    Obsolete
    PROXI_SEMIATTENDED
    Obsolete
    PROXI_UNATTENDED
    Obsolete
    TELEPHONE_ORDER
    Telephone order channel Acquiring contract: MOTO
  • recordSequence
    presence
    Required
    Interface version
    4
    Order
    1

    Transaction order in a Office Batch file.

  • transactionReference
    presence
    Required
    Interface version
    4
    Order
    3

    The merchant can choose of referencing his transactions by a transactionId or a transactionReference.transactionReference uniquely identifies a transaction throughout the life of the shop.

Optional