On This Page

issuer_additionalData

Data defined by the issuer.
This field is available only for Visa and Mastercard on the
Visa Platform Connect
 processor.
The value for this field corresponds to the following data in the TC 33 capture file:
  • Record: CP08 TCR1
  • Position: 5-168
  • Field: Free Form Text
The tables provide examples of the formats for discretionary data specific to acquirers for issuer-funded installment payments. The issuers and acquirers work together to develop and reach consensus on the formats. You must contact your acquirer for information about the formats to use.
Review the issuer data when issuer additional data is part of the response. To ensure the transaction is fully supported by the issuer, it's important to closely inspect the issuer data to ensure it follows the format provided with the issuer’s specification. Should you find any discrepancies in the data, please initiate the required follow-on transactions.
Example:
 Discretionary Data Format for Issuer-Funded Installment Payments with Visa Guatemala
VC10000000050000
Discretionary Data Format for Issuer-Funded Installment Payments with Visa Guatemala
Position (Character or Digit #)
Number of Characters or Digits
Description
1-2
2
Prefix. Set this value to
VC
.
3-4
2
Total number of installments.
5-16
12
Total amount.
Example:
Discretionary Data Format for Issuer-Funded Installment Payments with Visa Uruguay
00612012345678910000000008160003359
Discretionary Data Format for Issuer-Funded Installment Payments with VisaNet Uruguay
Position (Character or Digit #)
Number of Characters or Digits
Description
1-2
2
Plan type.
Set this value to
00
.
Specifies that the transaction is an e-commerce transaction.
3
1
Grace period. Number of months that the issuer waits before charging customers.
4-5
2
Total number of installments.
Possible values:
00
 through
99
.
6
1
POS entry mode.
Set this value to
0
.
Specifies that the transaction is an e-commerce transaction.
7-15
9
Identity document number.
Set this value to the number on the customer’s identity document or leave it blank.
Format: right justified with 0 (zero) padding on the left.
16
1
Financial inclusion law indicator. Possible values:
  • 1
    : Law 17934
  • 2
    : Law 18099
  • 3
    : Asignaciones familiares (AFAM) (family allowance program)
  • 4
    : Real state law
  • 5
    : Law 19210
17-28
12
Financial inclusion amount.
This value is the amount the bank returns to the customer.
29-35
7
Merchant-generated invoice number.
Example : Discretionary Data Format for Issuer-Funded Installment Payments with Mastercard Taiwan
Field
Position
Length
Description
Filler
1 - 90
90
Spaces
Installment-Tx-Indicator
91
1
Installment Transaction Indicator
Installment-Tranaction Response Code
92 - 93
2
Installment Transaction Response Code
Filler
94 - 120
27
Spaces
Period Number
121 - 122
2
Period Number
Down Payment
123 - 130
8
Down Payment
Installment Payments
131 - 138
8
Installment Payments
Formality Fee
139 - 144
6
Formality Fee

Specifications

  • Data Type:
     String
  • Data Length:
     255
For an authorization, the maximum length for this value is 255 characters. In the capture file, the value is truncated at 164 characters.

Mapping Information

  • REST API Field:
    issuerInformation.discretionaryData
     and
    processingInformation.issuer.discretionaryData
  • SCMP API Field:
    issuer_additional_data
  • Simple Order API Field:
    issuer_additionalData