If your business operates under specific travel-related Merchant Category Codes (MCCs), you can provide enhanced scheme data (ESD) to optimize your interchange rates. Car rental data consists of industry-specific details such as rental dates or rental agreements.
You get benefits for transactions, depending on the scheme:
- Visa: prevent downgrades to higher commercial standard rates.
- Mastercard: ensure that your transactions qualify for the interchange rates specific to your industry.
Requirements
In addition to the requirements that apply to sending ESD, take into account the following additional limitations for sending car rental data.
| Requirement | Description |
|---|---|
| Limitations |
|
MCCs for sending car rental data
You can send car rental data if you have one of the following MCCs:
| MCC | Description | Scheme |
|---|---|---|
| 3351-3500 | Automobile/vehicle rentals | Mastercard, Visa |
| 7512 | Automobile rental agency | Mastercard, Visa |
| 7513 | Truck and utility trailer rentals | Mastercard, Visa |
| 7519 | Motor home and recreational vehicle rentals | Mastercard |
How it works
You include car rental data in the enhancedSchemeData.carRental object. The object has the same fields in each request that supports it.
- Review the fields to send and the requirements that apply to your MCC.
- Include the car rental data in one of the following requests. The request to use depends on your capture setting:
- Automatic capture and Delayed automatic capture: the /payments request.
- Manual capture (Single partial capture and Multiple partial capture): the /payments/{paymentPspReference}/captures request.
- Check that you get a successful response.
Send car rental data
Include the following fields in the enhancedSchemeData.carRental object of your /payments or /payments/{paymentPspReference}/captures request.
| Field | Required | Description | Value |
|---|---|---|---|
| carRental.rentalAgreementNumber String |
The rental agreement number for the car rental. | Format:
|
|
| carRental.renterName String |
The name of the person who rents the car. | Format:
|
|
| carRental.returnInfo.city String |
The city where the renter must return the car. | Format:
|
|
| carRental.returnInfo.stateOrProvince String |
The state or province where the renter must return the car. | Format:
|
|
| carRental.returnInfo.countryCode String |
The country where the renter must return the car. | Format: Two-letter ISO 3166-1 alpha-2 code | |
| carRental.returnInfo.locationId String |
The agency code, phone number, or address abbreviation for the return location. | Format:
|
|
| carRental.returnInfo.date String |
The date by which the renter must return the car. | Format: ISO 8601 date: yyyy-MM-dd |
|
| carRental.pickupInfo.date String |
The date when the renter picks up the car. | Format: ISO 8601 date: yyyy-MM-dd |
|
| carRental.rentalRate Integer |
The rental rate. The rateType field specifies how often this rate applies. |
Format:
Example: 2000 means USD 20.00. |
|
| carRental.rateType String |
Indicates how often the rental rate applies. | Possible values:
|
|
| carRental.rentalDays Integer |
The number of days that the renter rents the car for. | Format:
|
|
| carRental.customerServicePhoneNumber String |
The customer service phone number of the car rental company. | Format:
|
|
| carRental.pickupInfo.city String |
The city where the renter picks up the car. | Format:
|
|
| carRental.pickupInfo.stateOrProvince String |
The state or province where the renter picks up the car. | Format:
|
|
| carRental.pickupInfo.countryCode String |
The country where the renter picks up the car. | Format: Two-letter ISO 3166-1 alpha-2 code | |
| carRental.rentalClassId String |
The classification of the rental car. | Format:
|
|
| carRental.taxExempt Boolean |
Indicates whether the goods or services were tax-exempt, or whether tax was not collected. | Possible values:
|
|
| carRental.rentalSurcharges.fuel Integer |
The fuel charges for the rental. | Format:
|
|
| carRental.rentalSurcharges.insurance Integer |
The insurance charges for the rental. | Format:
|
|
| carRental.rentalSurcharges.oneWayDropOff Integer |
The charge for not returning the car to the original rental location. | Format:
|
|
| carRental.noShow Boolean |
Indicates whether the customer did not pick up the rental car. | Possible values:
|
Select the endpoint for the corresponding request example:
Test sending car rental data
Use the following test card to make test payments with car rental data:
| Card Number | Card Type | Expiry Date | CVV |
|---|---|---|---|
| 5555 5555 5555 4444 | Mastercard | 03/2030 | 737 |
| 4444 3333 2222 1111 | Visa | 03/2030 | 737 |