HEV Status Report
The HEV Payout Status Report is the same as the normal status report , but with some additional columns included. The status report is a CSV report that is sent to you on a daily basis. This report is generated at 6am EST and includes information about all pending and recently completed Payouts. The report can be consumed via SFTP or email attachment.
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.
Status Report Example
Status reports that include HEV transfers will follow the same naming convention and structure with the addition of the following columns:
- HEV DATE
- HEV Currency
- HEV Amount
- Original Currency
- Original Amount
| Column | Description | Data type | Required | Example |
|---|---|---|---|---|
| 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 |
| 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 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 | |
| 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 | |
| Archived Reference ID | If this payout was generated in the portal as a reissue of a previous payout, the reference ID of the original payout will be stored here. | Text (1-50) | 123456 | |
| Reissued Reference ID | If this payout was archived and reissued as a new payout, the ID of the newly created payout will be stored here. | Text (1-50) | 678594 | |
| Batch Source | Source from which the payout was created. | "Batch" or "API" | Batch | |
| 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 | |
| HEV Currency | Currency of the original payment | ISO-3 | MXN | |
| HEV Amount | Total amount of the Payout in a decimal format (minimum amount = $1.00) | Decimal (1-9999999) | 1000.00 | |
| Original Currency | Currency of the original payment | ISO-3 | MXN | |
| Original Amount | Amount of the original payout | Decimal (1-9999999) | 1000.00 |
Updated 4 days ago
What’s Next