Request a checkout
REST endpoint
Use the Create checkout endpoint to request a new checkout session for a customer transaction. Requests for this endpoint are authenticated with the merchant's hosted checkout private token. When the merchant sets up hosted checkout, the tokens created are automatically set with the required Clover permissions.
Note
Tokens created when the merchant sets up hosted checkout are automatically set with the required Clover permissions.
Required data
At a minimum, a checkout session request must include an empty customer
object and a shoppingCart
with one or more items.
{
"customer": {},
"shoppingCart": {
"lineItems": [
{
"name": "Floor lamp",
"unitQty": 1,
"price": 10900
}
]
}
}
The cart provides information about the item or items being purchased. Items are represented in a shoppingCart
object composed of the following fields. The cart contains a lineItems
array of one or more lineItem
objects. A lineItem
must include a price
in cents, a name
, and the unitQty
(the number of the item the customer is purchasing).
Optional customer information
You can provide a better user experience by sending additional data in your request. If you include the customer’s name and contact information, this data will be populated in the checkout form. The customer
object can include the following fields:
firstName
lastName
phoneNumber
email
(this address receives a receipt when the checkout process is finished)
{
{
"customer": {
"email": "[email protected]",
"firstName": "Customer",
"lastName": "Name",
"phoneNumber": "6205551010"
}
}
}
Optional cart information
A cart’s lineItems
can include a note
to further describe the item. For example, you may need to provide additional information about the item if there are variants available for purchase. If you want to add tax information to a line item, see Adding taxes to transactions.
{
"lineItems": [
{
"note": "No pulp",
"name": "Orange juice",
"price": 600,
"unitQty": 2
},
{
"note": "Non-dairy",
"name": "French toast",
"price": 1200,
"unitQty": 1
}
]
}
Adding taxes to transactions
Because your requests are not linked to the merchant’s Clover inventory, any default tax configuration is not applied to hosted checkout payments. There are two requirements for taxes to be applied to a request:
- The merchant must have an existing tax rate.
- The tax is included on any applicable line items in the request. Add the
taxRates
array and arate
whose value matches one of the merchant’s tax rates. Therate
is an integer where a 10% tax is defined as1000000
. If more than one rate has the same value, the first will be used for the checkout process.
{
"lineItems": [
{
"name": "Mug",
"price": 1000,
"unitQty": 1,
"taxRates": [
{
"name": "CO state tax",
"rate": 1000000
}
]
}
]
}
Updated 10 months ago