Sending lodging data with the API

---
tags: [form, hospitality]
---

| Background                                                                                                                                                                                                                                                                                                                                                                                                               |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Before starting this tutorial, make sure you understand the following topics from the [Quick start](doc:quick-start) section: |
| <ul style={{ marginTop: "-5px", marginBottom: "-5px" }}> |
| <li>[Sandbox environments](doc:sandbox-environments) (especially about testing).</li> |
| <li>[Authentication](doc:authentication) (about authenticating using your API user and when you need a login versus a one-time-use token).</li> |
| </ul> |

Merchants in the lodging industry can pass certain parameters.

Only card-based requests are allowed, but you can use both the ecommerce or retail flows for terminal or remote.

The entire lodging object is optional. However, the following are all the supported parameters:

* Advanced Deposit (`lodging.advanceDeposit`)
* Check-in Date (`lodging.checkInDate`)
* Check-out Date (`lodging.checkOutDate`)
* No Show (`lodging.noShow`)
* Room Number (`lodging.roomNumber`)
* Room Rate (`lodging.roomRate`)
* Folio Number (`customer.orderNumber`)

1. **Post Card Inforation to Nexio**

   Send a `POST` request to the [Run card transaction](ref:runcardtransaction) endpoint.\
   Include the lodging object and the folio number in the body of your request.

   > πŸ“˜ Note
   >
   > Folio number must be sent in the `customer` object, labeled `orderNumber`.

   ```shell Example
   curl -X POST https://api.nexiopaysandbox.com/pay/v3/process \
     -H 'Content-Type: application/json' \
     -H 'Accept: application/json' \
     -H 'Authorization: Basic [Base64_encoded_login]'
     -d '{
     "data": {
       "lodging": {
         "advanceDeposit": true,
         "checkInDate": "2018-12-31",
         "checkOutDate": "2019-01-05", 
         "roomNumber": 14, 
         "roomRate": 143.99
       },
       "customer": {
         "orderNumber": 4566
       }
     },
     "tokenex": {
       "token": "6ee140a0-05d1-4958-8325-b38a690dbb9d"
     }
   }'