Schema Changes from V9.0 through V9.16
The table below includes elements added in schema version 9.x.
Schema version 9.0 was released at the same time as version 8.27. Changes made in version 8.28 were also made in version 9.1. Also, several feature developed in the V10.x, 11.x, and 12.x streams were back ported to 9.x versions. Version 9.5 was never made generally available.
TABLE 1-7 New Elements in V9.0 to V9.16
New Element |
Parent of |
Child of |
Comments |
---|---|---|---|
|
|
|
The parent element for the transaction type that a Payment Facilitator uses to distribute funds to themselves (i.e., from the PayFac Settlement Account to the PayFac Operating Account). |
|
|
|
The parent element for the transaction type that a Payment Facilitator uses to move funds from the PayFac Operating Account back to the PayFac Settlement Account. |
|
|
|
The parent element for the transaction type that a Payment Facilitator uses to move funds from the PayFac Settlement Account to the Sub-merchant Account. |
|
|
|
The parent element for the transaction type that a Payment Facilitator uses to move funds from the Sub-merchant Account to the PayFac Settlement Account. |
|
|
|
The parent element for the transaction type that a Payment Facilitator uses to move funds from the PayFac Settlement Account to the PayFac Reserve Account. |
|
|
|
The parent element for the transaction type that a Payment Facilitator uses to move funds from the PayFac Reserve Account to the PayFac Settlement Account. |
|
|
|
This specifies the identifier of the sub-merchant whose funds are moved by the instruction. |
|
|
|
This specifies the Payment Facilitator assigned identifier for the transaction. You must use unique values for each transaction across you entire organization. |
|
|
|
This specifies the name of the Sub-merchant. |
|
|
|
The parent element for information returned to you in response to a |
|
|
|
The parent element for information returned to you in response to a |
|
|
|
The parent element for information returned to you in response to a |
|
|
|
The parent element for information returned to you in response to a |
|
|
|
The parent element for information returned to you in response to a |
|
|
|
The parent element for information returned to you in response to a |
|
|
|
Use this transaction type to preform an eCheck Prenotification, when the subsequent eCheck transaction will be an eCheck Credit transaction. |
|
|
|
Use this transaction type to preform an eCheck Prenotification, when the subsequent eCheck transaction will be an eCheck Sale transaction. |
|
|
|
This is the parent of the response message to an |
|
|
|
This is the parent of the response message to an |
|
|
|
The parent element for the transaction type that a Payment Facilitator uses to move funds from the PayFac Settlement Account to a third party that issues physical checks on behalf of the Payment Facilitator. |
|
|
|
The parent element for information returned to you in response to a |
|
|
|
The parent element for the transaction type that a Payment Facilitator uses to move funds from a third party who issues physical checks on the Payment Facilitator’s behalf to the PayFac Settlement Account. |
|
|
|
The parent element for information returned to you in response to a |
|
|
|
The parent element for the transaction type that a Payment Facilitator uses to move funds from the PayFac Settlement Account to a Vendor account. |
|
|
|
The parent element for information returned to you in response to a |
|
|
|
The parent element for the transaction type that a Payment Facilitator uses to move funds from a Vendor account to the PayFac Settlement Account. |
|
|
|
The parent element for information returned to you in response to a |
|
|
|
Specifies the name of the vendor involved in the funding instructions |
|
|
|
Used to designate Apple Pay as the method of payment. |
|
|
saleResponse registerTokenRespo nse |
Includes information about the Apple Pay transaction. |
|
|
|
Defines the primary account number associated with the application. |
|
|
|
Defines expiration date of the application primary account number. |
|
|
|
The 3-character code for the currency used in the transaction. |
|
|
|
The amount of the transaction. |
|
|
|
The name of the cardholder. |
|
|
|
Defines the manufacturer of the device originating the transaction. |
|
|
|
Specifies the data type of the payment data associated with an Apple Pay transaction. |
|
|
|
Specifies the BASE64 Encoded signature cryptogram associated with the Apple Pay transaction. |
|
|
|
Specifies electronic commerce indicator associated with an Apple Pay/Google Pay transaction. |
|
|
|
Defines the principal portion of the total amount when a convenience fee applied to the transaction by the merchant. for example, if the total charge is $105, with the principal amount being $100 and the convenience fee being $5, you must use $100 as the value for the secondaryAmount element. Supply the value in cents without a decimal point. For example, a value of 400 signifies $4.00. |
|
|
|
The |
|
|
|
This element is intended for use by Payment Facilitators using Instruction Based Dynamic Payout to submit a description of the transaction. The description will appear in the extended detail section of the receiver’s bank statement, if that section is supported by the receiver’s bank. |
|
|
|
It provides the last four digits of the actual PAN for Apple Pay and Android Pay transactions, when the underlying card is either Visa or MasterCard. |
|
|
|
You use this element to define a Visa transaction is intended to fund a host-based prepaid product, a brokerage account, or an escrow account. Other enum values used for card on file transactions. |
|
|
|
The |
|
|
|
The cryptogram element is an optional child of the |
|
|
|
The |
|
|
|
The |
|
|
|
The |
|
|
|
This element was added to the |
|
|
|
Added |
|
|
|
This new method of payment allows transactions using the Single Euro Payments Area Direct Debit network. |
|
|
|
The International Bank Account Number of the consumer. |
|
|
|
Defines weather the merchant or Worldpay supplies the mandate. |
|
|
|
This element defines the purchase in terms of a one-time buy or a member of a recurring stream of debits. Attributes are: OneTime, FirstRecurring, SubsequentRecurring, and FinalRecurring. |
|
|
|
You use this element for recurring payments (after the initial transaction) to provide the reference number that links subsequent payments in a recurring stream to the mandate agreed to at the time of the initial payment. Worldpay returns this value in the |
|
|
|
This element defines the URL of the mandate to which the consumer agreed, allowing the merchant to debit their account. Although optional, you should always provide this information when the value for the |
|
|
|
This element defines the date the consumer agreed to the mandate allowing the merchant to debit their account. Although optional, you should always provide this information when the value for the |
|
|
|
This defines the language in which the merchant prefers the mandate to appear. While the merchant could be able to select any language, the mandate may not be available in the selected language. If the selected language is not available, the mandate appears in English. If you do not include this element, the preferred language defaults to the language indicated by the country of the IBAN, unless it is not available, in which case the language defaults to English. |
|
|
|
This element, returned for |
|
|
|
This element defines the URL that hosts the mandate, when Worldpay supplies the mandate. If you supply the mandate ( |
|
|
|
This element defines a value you can use to verify the approval of the Mandate by the consumer. |
|
|
|
This new method of payment allows transactions using the iDEAL Real-time Bank Transfers. |
|
|
|
This element, returned for |
|
|
|
Specifies information (equivalent of Bill Descriptor for a credit card transaction) that appears on the consumer bank statement along with a reference string representing the transaction. |
|
|
|
This new method of payment allows transactions using the Giropay Real-time Bank Transfers. |
|
|
|
This element, returned for |
|
|
|
This new method of payment allows transactions using the Sofort Real-time Bank Transfers |
|
|
|
This element, returned for |
|
|
|
Must be present when the marketplace and retailer are not in the same region (country). A value of 'F' indicates that the retailer is located in a different country. |
|
|
|
Required if you submit an Incremental Authorization, used by certain Travel and Entertainment (T&E) merchants. when final purchase amounts are unknown. |
Other schema changes:
-
New enumeration for
<orderSource>
,applepay
. Use this value for Apple Pay transactions. -
Change in
maxLength
of theauthenticationValue
element - from 32 to 56 characters. -
New enumeration for
<orderSource>
,androidpay
. Use this value for Android Pay transactions. -
New enumeration for
<walletSourceType>
,VisaCheckout
. Use this value for transactions involving the Visa Checkout service. -
The
minLength
forroutingNum
changed from 9 to 8 characters to accommodate some Canadian routing numbers. -
The
version
element, a child ofapplepay
changed from 20 characters to 10 characters. -
New enumerations added to the
processingType
element to support recurring and installment card on file transactions. The new enumerations are: initialRecurring, and initialInstallment. -
New enumerations added to the
processingType
element to support card on file transactions. The new enumerations are: initialCOF,merchantInitiatedCOF
, andcardholderInitiatedCOF
.