curl -X POST "https://integration.example.com/api/vendor/v1/quote" \
-H "X-API-Key: $GOMRY_RETAIL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"vendorKey": "acme",
"vendorListingId": "tg_88412093",
"quantity": 2,
"retailPrice": 118.4,
"reference": "8b1f3c5e2a9d4f7081c6e2b4a0d9f3e1"
}'
{
"retailTax": 17.76,
"wholesaleTax": 0,
"taxSignature": "lock_7d2e91c4",
"totalCost": 192.0,
"currency": "USD"
}
{
"error": {
"code": "validation_error",
"message": "Quantity 3 is not an allowed split for this listing"
}
}
Purchasing
Quote
Price a purchase, including tax on both legs, and return the signature the order must carry
curl -X POST "https://integration.example.com/api/vendor/v1/quote" \
-H "X-API-Key: $GOMRY_RETAIL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"vendorKey": "acme",
"vendorListingId": "tg_88412093",
"quantity": 2,
"retailPrice": 118.4,
"reference": "8b1f3c5e2a9d4f7081c6e2b4a0d9f3e1"
}'
{
"retailTax": 17.76,
"wholesaleTax": 0,
"taxSignature": "lock_7d2e91c4",
"totalCost": 192.0,
"currency": "USD"
}
{
"error": {
"code": "validation_error",
"message": "Quantity 3 is not an allowed split for this listing"
}
}
Quote
Prices a prospective purchase. Quoting is a required step, not an optimisation: Retail will not place an order without thetaxSignature this returns, and your order endpoint should reject one whose signature does not match.
Quoting moves no money, so Retail may call it more than once for the same checkout.
Body
string
required
Your supplier identifier.
integer
required
Tickets to price. Always one of the listing’s
splits.number
The per-ticket price Gomry sells at, so you can quote the sales tax owed on the retail leg. The order will carry the same value as
unitCost. If your system has no retail leg, ignore it.string
Retail’s reference for the order this quote leads to. The order will carry the same value.If your system cannot price without taking the seats off the market (a hold or lock), key that hold on this reference. A replayed checkout then finds its own hold instead of taking a second one. A quote under one reference followed by an order under another should be refused.
Response
All amounts are totals for the wholequantity.
number
required
Sales tax owed on the retail leg, in the event’s jurisdiction.
0 only when none is due, never because retailPrice was ignored.number
required
Tax you charge Gomry Retail on the wholesale leg.
0 where resale certificates apply.string
required
Ties an order to this quote. Retail sends it back on Place order. If your system has no signature of its own, generate one you can verify, such as the id of the hold you placed.
number
required
What Gomry Retail will pay you for this purchase, including
wholesaleTax.string
required
ISO 4217 code for every amount above.
Errors
Answer400 when your system refuses the quote in words: the listing is gone, the quantity is not allowed, the hold could not be placed. Answer 404 for a listing you do not know. Retail declines the purchase before any order is placed, and the buyer is told the listing is no longer available.
curl -X POST "https://integration.example.com/api/vendor/v1/quote" \
-H "X-API-Key: $GOMRY_RETAIL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"vendorKey": "acme",
"vendorListingId": "tg_88412093",
"quantity": 2,
"retailPrice": 118.4,
"reference": "8b1f3c5e2a9d4f7081c6e2b4a0d9f3e1"
}'
{
"retailTax": 17.76,
"wholesaleTax": 0,
"taxSignature": "lock_7d2e91c4",
"totalCost": 192.0,
"currency": "USD"
}
{
"error": {
"code": "validation_error",
"message": "Quantity 3 is not an allowed split for this listing"
}
}