DiVert Batch Result File Data Elements

 
The result file data elements described in this section are returned to the merchant when the <CreateTransactionURL> in the “DivertUpload” file is set to “True”. Merchants can use the returned data elements to create and format their own payment request messages and send the requests to their cardholder using their own delivery method i.e. SMS|EMAIL

The Divert Batch has the following logic:

  • The <Divert> element can occur multiple times
  • The <DivertItem> element can occur multiple times under a <Divert> element


Divert Attributes

Tag Name

Length

Data Type

Format

Description

Amount

<=12

Numeric

 

The sum of the Amount sub-element values of all the <DivertItem> sub-elements

 

Count

<=6

Number

 

The number of <DivertItem> sub-elements

 


Divert sub-elements

Tag Name

Length

Data Type

Format

Description

Date

8

Numeric

 

The date when the batch was created (in which case the batch will be processed on the upload date) or a future date on which the batch should be processed (a past or future date cannot be more than 1 calendar month from the upload date)

 

File Name

<=64

Text

 

The Filename by which the Divert batch can be identified (must be unique for all Divert batches uploaded for an ApplicationID)

 

CreateTransactionUrl

Boolean

 

True|False

Generated URL to which a payment can be made by the cardholder.

DivertItem

 

 

XML element

An element for each transaction in the Divert Batch, this can occur multiple times within a <Divert> 

 


DivetItem Attributes

Tag Name

Length

Data Type

Format

Description

Application ID

38

GUID

{00000000-0000-0000-0000-  000000000000}

 

The ApplicationID allocated generated by the gateway during merchant capture (the same ApplicationID must be used for all DivertItem elements under a Divert element)

Mode

4

Text

Test|Live

The mode of an ApplicationID

Command

<=64

Text

Debit|Authorisation|Credit| etc.

The Transaction type used

RequestID

38

GUID

{00000000-0000-0000-0000-  000000000000}

A unique identifier for the transaction allocated by iVeri


DivertItem sub-elements

Tag Name

Length

Data Type

Format

Description

TransactionURL

<=255

Text

 

This will be returned to the merchant in the result file if the ‘CreateTransactionUrl’ parameter set to ‘True’

 

MerchantReference

<=64

Text

 

Unique merchant reference for this transaction. Must be unique for each DivertItem with Divert uploaded for an Application ID(normally  this an Invoice Number)