# Additional Data Fields source: https://developer.mastercard.com/cross-border-services/documentation/additional-resources/common-additional-data/index.md Receiving Institutions may require additional data from the Originating Institution (OI) in the API calls that are not standard for all calls. Note: This following list contains the additional_data fields that might be required. Actual fields required for each corridor are provided in the Originating Institution's Technical Endpoint Guide (TEG) during the onboarding process. The field names are the numbers provided in the "Data Field Name" column below. For example, the 1200 field name would be formatted as below: * XML ```XML 1200 123COM-WE-MWALLET ``` ## Request API Call -- Additional Data Fields {#request-api-call--additional-data-fields} | Data Field Name | Additional Data | Description | |-----------------|--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **108** | Sender Alias (other) | Sender's formal alias name, as provided by the Originating Institution (OI) in case of consumer type. Latin characters only. **Note:** This field shall serve the Singapore alias name scenario, where 20% of the Singaporean individuals have a formal alias on their ID card. | | **121** | Sender Mobile Phone Number | Sender's mobile phone number, as provided by the sender, as an E164 number (digits only, no hyphenation). This is a contact number, and may be different from the source URI that may identify an independent mobile wallet. **For example:** `+33612345678` | | **122** | Sender Landline Number | Sender's landline number, as provided by the sender, as an E164 number (digits only, no hyphenation). This is a contact number, and may be different from the source URI that may identify an independent mobile wallet. **For example:** `+33612345678` | | **125** | Sender E-mail address | **For example:** `sender1@gmail.com` | | **153** | Sender ID Issued by | Sender's ID issuing authority. May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. **For example:** `Passport office` | | **161** | Sender Place of Birth | Sender's place of birth, as mentioned on his/her official ID documents. May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. **For example:** `Toulouse, France` | | **170** | Sender Occupation | Sender's occupation (job/position). May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. **Valid values:** - `General Worker` -- General Worker - `Businessman` -- Businessman - `Professional` -- Professional - `Supervisor` -- Supervisor - `Tourist` -- Tourist - `Security Guard` -- Security Guard - `House Maid` -- House Maid - `Domestic Helper` -- Domestic Helper - `House Wife` -- House Wife - `Others` -- Other occupation not classified above | | **180** | Sender Relationship with Beneficiary | Sender relationship with recipient. **Valid values:** - `Parent` -- Parent - `Child` -- Child - `Spouse` -- Spouse - `In-laws` -- In-laws - `Relative` -- Relative - `Self` -- Self - `Family Friend` -- Family Friend - `Employee` -- Employee - `Friend` -- Friend - `Supplier` -- Supplier - `Service Provider` -- Service Provider - `Donor/ Receiver of Charitable Funds` -- Donor / Receiver of Charitable Funds - `Trade/ Business Partner` -- Trade / Business Partner | | **204** | Organization Name (other) | Receiver/beneficiary's name when it is a business, as provided by the sender. May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. Serves as a spare field in cases where the Receiving Institution (RI) expects the beneficiary's name in two different languages. **Allowed structure for Consumer:** - `First_Name` -- Required - `Last_Name` -- Required - `Middle_Name` -- Optional **Allowed structure for Business / Government / Non‑Government Organization:** - `Organization Name` -- As defined by the receiving party's naming requirements | | **205** | Receivers First Name (other) | Recipient's first name, as provided by the sender. May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. Spare field (in case RI is expecting the beneficiary's name in 2 different languages). | | **206** | Receivers Middle Name (other) | Recipient's middle name, as provided by the sender. May contain[Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. Spare field (in case RI is expecting the beneficiary's name in 2 different languages). | | **207** | Receivers Last Name (other) | Recipient's last name, as provided by the sender. May contain[Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. Spare field (in case RI is expecting the beneficiary's name in 2 different languages). | | **208** | Recipient Alias (other) | Recipient's formal alias name, as provided by the OI in case of consumer type. Latin characters only. **Note:** This field shall serve the Singapore alias name scenario, where 20% of the Singaporean individuals have a formal alias on their ID card. | | **222** | Recipient Landline Number | Recipient's landline number, as provided by the sender, as an E164 number (digits only, no hyphenation). **For example:** `+33412345678` | | **253** | Recipient ID Issued By | Recipient's ID issuing authority. May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. **For example:** `Passport office` | | **260** | Recipients Date of Birth | Recipient's date of birth. In case of Business, Government/Non-Government Organization: Established Date. | | **261** | Recipient Place of Birth | Recipient's place of birth, as mentioned on his/her official ID documents. May Contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. **For example:** `Toulouse, France` | | **270** | Recipient Occupation | Recipient's occupation (job/position). May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. **For example:** `Laborer` | | **409** | Additional Communication | Additional Information field. A free communication field (structured or unstructured) as provided by the sender. May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. | | **430** | Payer Payee Relationship | This field will capture Payer Payee Relationship. May contain [Unicode](https://developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/index.md) characters. **Valid values for P2P payments:** Father, Mother, Daughter, Son, Parent, Child, Sibling, Spouse, Sister, Brother, Wife, Husband, Father-in-Law, Mother-in-Law, Aunty, Uncle, Cousin, Nephew, Niece, Grand Mother, Grand Father, Grand Daughter, Grand Son, Friend, Friend's Mother, Friend's Father, Self **Valid values for B2B payments:** Supplier, Service Provider, Trading partner, Business Partner, Outsourcing, Importer/Exporter, Seller, Buyer **Valid values for B2P payments:** Consultant, Contractor, Employee **Valid values for P2B payments:** Importer/Exporter, Seller, Buyer | | **511** | Future Processing Date | Customer who would like to use the payment scheduling service must provide a future processing date in this field. The date must be within the min and max day interval which is 7 to 14 days. The date must be in `yyyy-mm-dd` format. **For example:** `2024-08-01` | | **520** | Recipient Notification | Consent to send recipient notification for a transaction. | | **630** | Beneficiary Bank Account Type | Beneficiary Account Type (Requirement for Brazil and Ecuador). **Valid values:** - `C` -- Checking - `P` -- Savings | | **650** | Sender Bank Region | This parameter contains the region of the bank institution from which the sending consumer is instructing the transaction. This parameter holds a string of [alphanumeric special](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters with a maximum length of 64 and a minimum length of 1. **For example:** `69999` | | **660** | Recipient Bank Region | This parameter contains the region of the bank institution to which the recipient consumer is receiving the transaction. This parameter holds a string of [alphanumeric special](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters with a maximum length of 64 and a minimum length of 1. **For example:** `69999` | | **701** | Destination Country | Destination Country. ISO 3166-Alpha-3 country code, in uppercase. **For example:** `FRA` | | **1150** | Debtor Agent Name | Debtor Agent Name (typically used for a Payment On Behalf Of (POBO) scenario). | | **1154** | Debtor Agent Address Street 1 | Debtor Agent Address Street 1: street name/number. May contain[Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. | | **1155** | Debtor Agent Address Street 2 | Debtor Agent Address Street 2: street name/number. (field reserved for systems which split street address in 2 lines) May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. | | **1156** | Debtor Agent Address City | Debtor Agent Address City. May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. | | **1157** | Debtor Agent Address Zip | Debtor Agent Address ZIP code. ASCII characters only. May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. | | **1158** | Debtor Agent Address State | Debtor Agent Address State. May contain [Unicode](https://stage.developer.mastercard.com/cross-border-services/documentation/api-basics/api-conventions/) characters. | | **1159** | Debtor Agent Address Country | Debtor Agent Address Country. This VSF encodes this information as an ISO 3166 Alpha-3 country code, in uppercase. **For example:** `FRA` | | **1160** | Ultimate Debtor Name | Name of the party that originally ordered goods or services and to whom the seller has sent the invoice. Ultimate Debtor is used to identify the party that originally ordered goods or services and to whom the seller has sent the invoice. Ultimate Debtor is used when the receiver of the invoice is different than the Debtor (Sender Name). | | **1161** | Intermediary Agent 1 Name | The name of the first Financial institution between the debtor's agent and the creditor's agent. There can be several intermediary agents specified for the execution of a payment. There can be one to many intermediary agents specified for the execution of a payment. | | **1162** | Intermediary Agent 2 Name | The name of the second Financial institution between the debtor's agent and the creditor's agent. There can be several intermediary agents specified for the execution of a payment. If needed. | | **1163** | Intermediary Agent 3 Name | The name of the third Financial institution between the debtor's agent and the creditor's agent. There can be several intermediary agents specified for the execution of a payment. If needed. | | **1200** | Destination Service Tag | The Destination Service tag value provided by Mastercard Cross-Border Services at time of onboarding; ensures transactions are delivered to preselected corridors. Free text. | | **7260** | Destination Payment Instrument | The destination payment instrument. | ## Response API Call -- Additional Data Fields {#response-api-call--additional-data-fields} | Data Field Name | Additional Data | Description | |-----------------|-----------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **501** | Maximum Cash Pickup Duration | The maximum time allowed for the receiver to collect the funds before the transaction is rejected. This value is expressed in days and returned only for **Cash Out** transactions. **Format:** ANS, up to 10 characters **For example:** `30 days` | | **590** | Rebate Eligibility Flag | Indicates whether the transaction qualifies for a rebate. **Valid values:** - `true` -- Transaction is eligible for rebate - `false` -- Transaction is not eligible for rebate | | **591** | Rebate Eligibility Code and Description | Specifies the reason why a transaction is eligible or ineligible for a rebate. **Valid values:** - `E` -- Eligible transaction - `T` -- Not eligible due to payment type criteria - `P` -- Not eligible due to purpose code criteria - `A` -- Not eligible because the amount is below the eligibility threshold - `D` -- Not eligible due to exceeding the daily eligibility quota per sender--beneficiary combination - `I` -- Eligibility could not be determined due to an internal error | | **592** | Rebate Amount and Currency | The rebate amount applied to the transaction, including the currency. **For example:** `10 SAR` | | **814** | Mastercard Trading Rate | The Mastercard Trading Rate used to process the transaction, excluding any Originating Institution (OI) or Cross-Border Services markup. This field is returned only for Mastercard OIs configured to receive it and only in payment response messages. **Format:** Decimal value (minimum length: 1, maximum length: 24) | | **830** | Rate ID | Returned only when an OI has opted in for **Carded Rates** and is configured for **Expired Rate** processing. Identifies the rate used to process the payment and is evaluated together with **Expired Rate Indicator (831)** . - When **831 = `RATE_HONORED`** , this value matches the `card_rate_id` provided in the payment request. - When **831 = `RATE_EXPIRED`** , this value differs from the `card_rate_id` in the request and represents the rate actually used for processing. | | **831** | Expired Rate Indicator | Returned only when an OI has opted in for **Carded Rates** and **Expired Rate** processing. Indicates whether the rate provided in the payment request was honored or expired and whether the settlement amount was recalculated. **Valid values:** - `RATE_HONORED` -- The requested rate was valid and used for processing. - `RATE_EXPIRED` -- The requested rate was no longer valid and a new FX rate was applied, resulting in a recalculated settlement amount. | | **840** | Quote ID | Returned for **Quote** and **Payment** responses when an OI is configured for **Expired Quote** processing. Provides a unique identifier for backend processing and reconciliation. This field is evaluated together with **Expired Quote Indicator (841)** . - When **841 = `QUOTE_HONORED`** , the Quote ID remains the same between Quote and Payment responses. - When **841 = `QUOTE_EXPIRED`**, the Quote ID in the Payment response differs from the Quote response and represents the quote used for recalculation. | | **841** | Expired Quote Indicator | Returned only for **Payment** responses when an OI is configured for **Expired Quote** processing. Indicates whether the quote used for the payment was honored or expired and whether the settlement amount was recalculated. **Valid values:** - `QUOTE_HONORED` -- The quote rate was still valid and honored. - `QUOTE_EXPIRED` -- The quote rate was no longer valid and a new FX rate was applied, resulting in a recalculated settlement amount. | | **890** | Max Queue Time | The latest timestamp by which sufficient balance must be available in the settlement account before the transaction is rejected. **Format:** `yyyy-MM-dd'T'HH:mm:ssXXX` **For example:** `2023-07-07T12:38:10Z` |