Private Label API Fields
Below are the fields required for private label cards.
| Field | Name | Length Type |
Description |
|---|---|---|---|
| 0406 | (07) ForcePurDesc (02) OrderDescription (09)AdjustmentDesc |
1-30 alphanumeric |
OPTIONAL. Item 1 text – Description of charges. |
| 0590 | User Name | 1-20 alphanumeric |
REQUIRED. User Name to log into or access a TPP. |
| 0591 | Password | 1-20 alphanumeric |
REQUIRED. Password to log in or access a TPP system. Data in this field should be encrypted when stored and masked when displayed. |
| 0608 | Product Amount 1 | 1-14 cents |
CONDITIONAL. Dollar amount of product item #1 Valid values are 0.00 – 9999.99. |
| 0615 | Promotion Code | 2-8 alphanumeric |
CONDITIONAL. Represents any promotion associated with the purchase. Values are issuer-specific (see valid options below). Should be table driven. |
| 0700 | ZipCode | 5–9 numeric |
OPTIONAL. Billing Zip Code. |
| 0701 | Address1 | 25 alphanumeric |
OPTIONAL. Billing Street Address. |
| 3401 | OFP Language | 1000 alphanumeric |
OPTIONAL. Free Form Text 1. Processor-Specific Must be printed on receipt |
| 3402 | OFP Language | 1000 alphanumeric |
OPTIONAL.Free Form Text 2. Processor-Specific Must be printed on receipt |
| 3403 | OFP Language | 1000 alphanumeric |
OPTIONAL.Free Form Text 3. Processor-Specific Must be printed on receipt |
note
API fields 3401, 3402, and 3403 are concatenated into a single response for printing on the customer receipt. For example, if the text in field 3401 exceeds 1000 characters, it will continue to field 3402.
Promo Codes and response language
The codes below are possible values for API field 0615 (Promotion Code). The response language is specific to our vendor and should not be changed.
Promo Code – 000
Response Language – None
Promo Code – 112
Response Language - No Interest Charges will be assessed if the promotional purchase balance is paid in full within the Promotional Period,which is in 12 months. If the promotional purchase balance is not paid in full by the end of this Promotional Period, interest will be imposed from the date of purchase at the variable Annual Percentage Rate of 15.49%. If the word variable appears in the previous sentence, that APR will vary with the market based on the prime rate. Minimum monthly payments are required. Regular account terms apply to non-promotional purchases and, after promotion ends, to promotional purchase.
Promo Code – 400
Response Language - No interest charges will be assessed on your promotional purchase balance and equal monthly payments are required equal to 4.1666% of initial promo purchase balance amount until the balance is paid in full. The equal monthly payment will be rounded up to the next highest whole dollar and may be higher than the minimum payment that would be required if this was a non-promotional purchase. Regular account terms apply to non-promotional purchases.
Promo Code – 401
Response Language - No interest charges will be assessed on your promotional purchase balance and equal monthly payments are required equal to 2.3255% of initial promo purchase balance amount until the balance is paid in full. The equal monthly payment will be rounded up to the next highest whole dollar and may be higher than the minimum payment that would be required if this was a non-promotional purchase. Regular account terms apply to non-promotional purchases.
Promo Code – 403
Response Language - No Interest Charges will be assessed if the promotional purchase balance is paid in full within the Promotional Period, which is by ** MM/YYYY **. If the promotional purchase balance is not paid in full by the end of this Promotional Period, interest will be imposed from the date of purchase at the Annual Percentage Rate of 29.99%. If the word variable appears in the previous sentence, that APR will vary with the market based on the prime rate. Minimum monthly payments are required. Regular account terms apply to non-promotional purchases and, after promotion ends, to promotional purchase.
Promo Code – 524
Response Language - Monthly interest will be assessed on your promotional purchase balance from the purchase date at the Promotional 14.90% Annual Percentage Rate until the balance is paid in full. Fixed monthly payments are required, and will be 4.8439% of initial promo purchase amount. The fixed monthly payment will be rounded up to the next highest whole dollar and may be higher than the minimum payment that would be required if this was a non-promotional purchase. Regular account terms apply to non-promotional purchases.
Promo Code – 718
Response Language - No interest charges will be assessed on your promotional purchase balance and equal monthly payments are required equal to 5.5555% of initial promo purchase balance amount until the balance is paid in full. The equal monthly payment will be rounded up to the next highest whole dollar and may be higher than the minimum payment that would be required if this was a non-promotional purchase. Regular account terms apply to non-promotional purchases.