HEV Response File
The HEV Payout Response file is provided back to you from Latitude in response to every HEV Payout Data File received (same as the normal response file, but it will include additional columns if it detects a HEV payout). The Response file will contain information about the status of each Payout as well as the link that will allow a recipient user to complete the Payout.
Historical Equivalent Value (HEV)
When a non-USD payout is created using QBSA, Latitude fetches the historical USD equivalent (interbank/ECB rate) on the original payment date. That USD value becomes the new fixed liability. If the recipient collects in their original currency, Latitude converts the payout to QBRA after processing.
Response File Example
A data row will be present in the Response File for every record received in the corresponding Data File. The data elements of the header row are defined in the table below along with the additional HEV Date column:
| Column | Description | Data type | Required | Example |
|---|---|---|---|---|
| Row identifier | Single character identifier used to determine the type of row: D = data | Text (1) | ✔️ | D |
| Reference Number | Unique ID used by you to reference the Transfer Request in within the Latitude product. This value is generated by you. This value is also the ID value used by the end user in the event they need customer support. Note: It is recommended to select a value that is already being used to reference this payment in your system however it must be unique for all transfer requests. | Text (1-50) | ✔️ | ABC123456 |
| Sender ID | Unique ID provided by the Latitude Integrations team referencing a specific sender configuration and account as the source of funds. | Text(1-50) | ✔️ | d82df35w-4723-3s09-9se7-d23hc3hes5a2 |
| Recipient First Name | Given name of the recipient | Text (1-50) | ✔️ | Josef |
| Recipient Last Name | Surname of the recipient | Text (1-50) | ✔️ | Martinez |
| Recipient Second Last Name | Maternal or second last name of the recipient | Text (1-50) | Jiminez | |
| Recipient Email Address | Email address of the recipient (this will determine where notification emails are sent) | Text (1-50) | ✔️ | [email protected] |
| Recipient Phone Number | Phone number of the recipient (last 4 of this phone number used for verification by user by default) | Text (4-50) | ✔️ | 555812345678 |
| Recipient Mailing Address Line 1 | Address line 1 of the recipient mailing address | Text (1-50) | PRIVADA UNIÓN 10 | |
| Recipient Mailing Address Line 2 | Address line 2 of the recipient mailing address | Text (1-50) | COL. AGRÍCOLA PANTITLÁN | |
| Recipient Mailing Address City | City of the recipient mailing address | Text (1-50) | CIUDAD DE MÉXICO | |
| Recipient Mailing Address State | State/Province of the recipient mailing address | Text (1-50) | IZTACALCO | |
| Recipient Mailing Address Postal Code | Zip/Postal code of the recipient mailing address | Text (1-10) | 30339 or 30339-0081 | |
| Recipient Mailing Address Country | Country of the recipient mailing address | ISO-3 | ✔️ | MXN |
| Payout amount | Total amount of the Payout in a decimal format (minimum amount = $1.00) | Decimal (1-9999999) | ✔️ | 150.99 |
| Payout Amount Currency | Currency of the Payout | ISO-3 | ✔️ | USD |
| Send or Receive | Quote by send or receive amount: SEND_AMOUNT specifies the amount the user is able to collect before any fees or FX rates (foreign exchange). RECEIVE_AMOUNT is the amount the user will collect in a desired currency irregardless of fees or FX rates. User will not be able to receive funds in a different currency than specified when using RECEIVE_AMOUNT. Any fees or FX rates will be calculated in the background with the applicable amount in USD deducted from the funding account in order to meet the RECEIVE_AMOUNT specified. | Text (1-50) | ✔️ | SEND_AMOUNT |
| Supplemental Information 1 | Additional field for notes for cross reference | Text (1-50) | This is an example | |
| Supplemental Information 2 | Additional field for notes for cross reference | Text (1-50) | This is an example | |
| Verification Code | Alternate verification method to the default last 4 digits of their phone number. This value should be a unique, private, and hard to guess string that only the end user recipient will know. Supplying a value in this field will disable the default verification method of using the last 4 of the phone number. | Text (4-50) | 3098sfDSi8e9a8 | |
| Supplemental Information 3 | Additional field for notes for cross reference | Text (1-50) | This is an example | |
| Supplemental Information 4 | Additional field for notes for cross reference | Text (1-50) | This is an example | |
| User ID | Indicator that can associate multiple payouts to a single user through a unique ID. | Text (1-50) | XYZ789 | |
| Recipient Type | Whether the payout is being sent to a person (B2C) or a business (B2B) entity. | "PERSON" or "BUSINESS" | PERSON | |
| HEV Date | Date of the original payment date | MM-DD-YYYY | 06-05-2025 |
Updated 4 days ago