{ "error": { "code": "validation_error", "message": "taxSignature does not match the quote for this reference: re-quote before ordering" }}
{ "error": { "code": "integration_error", "message": "Upstream order call timed out after 15000ms" }}
Place Order
Places an order for a listing. This is the endpoint that spends real money, and it is designed around one assumption: a reply can be lost after the order was placed.
Two submissions with the same reference can mean two real purchases unless your system deduplicates on it. reference is a search key for reconciliation, not a guarantee. Retail calls this endpoint once per order and never retries it.
What happens when a call fails
Retail cannot tell “the request never arrived” from “it arrived and the reply was lost”. So any failure here, whether a timeout, a dropped connection or a non-2xx status, is treated the same way: the order becomes unknown, and Retail finds out what happened by calling Search orders with the reference. It only submits again if that search proves no order exists.That makes two things your job:
Make a replay safe. Before placing anything, check whether an order already exists for this reference. If it does, return that order with 200. Never place a second one.
Do not retry internally. If your upstream call fails or times out, return 502 and let Retail search. An internal retry is exactly the double purchase this design exists to prevent.
Body
string
required
Your supplier identifier.
string
required
Retail’s reference for this order. Store it on your order so Search orders can find it. It is the same value the quote carried.
string
required
The listing being bought.
integer
required
Tickets to buy. One of the listing’s splits.
number
required
The per-ticket wholesale price Retail expects to pay, from the listing. Refuse the order if your price is now higher.
string
required
ISO 4217 code for unitCost.
string
required
The signature from the quote this order was priced from. Refuse the order if it does not match: it was priced against a different quote, or none.
number
The retail sales tax from that same quote, for your order record.
string
The price-lock token from the listing, if you issued one.
string
default:"eticket"
The listing’s delivery format, so you can address the order correctly. The same values as on Listings. Taken from the listing at the moment the buyer paid.
object
Where to courier a physical ticket. Present only when format is physical.
Show Shipping address
string
required
One full name. The person who can receive the parcel.
string
required
Contact phone for the carrier.
string
required
Street address.
string
Unit or apartment.
string
required
City.
string
required
State or region.
string
required
Postal code.
string
required
ISO 3166-1 alpha-2, for example US. A code, not a country name.
string
The buyer’s own email, for a seat transferred into their account. Present only when format is mobile_transfer or flash_seats. The box office moves the seat into the account that owns this mailbox, so it must be the buyer’s real address.
Refuse what you cannot deliver
format: "physical" without shippingAddress: refuse with 400. Many systems treat a missing recipient as “ship to the buying account”, which is right for an e-ticket and wrong for a parcel: it ships to Gomry Retail, silently, and the buyer never gets a ticket.
mobile_transfer or flash_seats without buyerEmail: refuse with 400. Never fall back to any address of your own or of Gomry’s.
shippingAddress and buyerEmail are the only buyer data that ever reaches your integration. Pass them to your system on this order and nowhere else. Do not store them, and keep them out of logs and error reports.
{ "error": { "code": "validation_error", "message": "taxSignature does not match the quote for this reference: re-quote before ordering" }}
{ "error": { "code": "integration_error", "message": "Upstream order call timed out after 15000ms" }}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Gomry API","colors":{"primary":"#000000","light":"#FFFFFF","dark":"#FFFFFF"},"logo":{"light":"https://mintcdn.com/gomry/jDJp3Wqzn5wDGgQC/images/logo-light.png?fit=max\u0026auto=format\u0026n=jDJp3Wqzn5wDGgQC\u0026q=85\u0026s=f219d76acf24de2d111ed934cfcb6606","dark":"https://mintcdn.com/gomry/jDJp3Wqzn5wDGgQC/images/logo-dark.png?fit=max\u0026auto=format\u0026n=jDJp3Wqzn5wDGgQC\u0026q=85\u0026s=72b9aee24c65cf76a8c0f17f88337855"},"favicon":"https://mintcdn.com/gomry/jDJp3Wqzn5wDGgQC/favicon.ico?fit=max\u0026auto=format\u0026n=jDJp3Wqzn5wDGgQC\u0026q=85\u0026s=a81575b3950229a1b14b4260130ce0bf","api":{"mdx":{"auth":{"method":"key","name":"X-API-KEY"},"server":"https://www.gomry.com/api/v1"}},"navbar":{"links":[{"href":"https://www.gomry.com","label":"Dashboard"}]},"footer":{"socials":{"website":"https://gomry.com","linkedin":"https://www.linkedin.com/company/gomry"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gomry","hasAudioNarration":false,"actualSubdomain":"gomry","customDomains":["docs.gomry.com"],"gitSource":{"type":"github","owner":"gomryhq","repo":"gomry","deployBranch":"master","contentDirectory":"docs/api-reference","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b00851f06faa1652edc0f9b","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":107},{"language":"default","tag":"Platform API","count":66},{"language":"default","tag":"Commerce API","count":16},{"language":"default","tag":"Distribution API","count":13},{"language":"default","tag":"Retail Vendor API","count":12},{"language":"default","tag":"Getting Started","count":8},{"language":"default","tag":"Checkout Sessions","count":7},{"language":"default","tag":"Contacts","count":6},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Overview","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"vendor-api/place-order","slug":"/vendor-api/place-order","pageMetadata":{"title":"Place Order","api":"POST https://integration.example.com/api/vendor/v1/orders","playground":"none","description":"Buy a listing. The one endpoint that spends money.","href":"/vendor-api/place-order"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Buy a listing. The one endpoint that spends money.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField,Table,Warning}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`place-order`,children:`Place Order`}),`\n`,_jsxs(_components.p,{children:[`Places an order for a listing. This is the endpoint that spends real money, and it is designed around one assumption: `,_jsx(_components.strong,{children:`a reply can be lost after the order was placed.`})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Two submissions with the same reference can mean two real purchases`}),` unless your system deduplicates on it. `,_jsx(_components.code,{children:`reference`}),` is a search key for reconciliation, not a guarantee. Retail calls this endpoint `,_jsx(_components.strong,{children:`once`}),` per order and never retries it.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`what-happens-when-a-call-fails`,children:`What happens when a call fails`}),`\n`,_jsxs(_components.p,{children:[`Retail cannot tell “the request never arrived” from “it arrived and the reply was lost”. So `,_jsx(_components.strong,{children:`any`}),` failure here, whether a timeout, a dropped connection or a non-2xx status, is treated the same way: the order becomes `,_jsx(_components.em,{children:`unknown`}),`, and Retail finds out what happened by calling `,_jsx(_components.a,{href:`/vendor-api/search-orders`,children:`Search orders`}),` with the reference. It only submits again if that search proves no order exists.`]}),`\n`,_jsx(_components.p,{children:`That makes two things your job:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Make a replay safe.`}),` Before placing anything, check whether an order already exists for this `,_jsx(_components.code,{children:`reference`}),`. If it does, return that order with `,_jsx(_components.code,{children:`200`}),`. Never place a second one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Do not retry internally.`}),` If your upstream call fails or times out, return `,_jsx(_components.code,{children:`502`}),` and let Retail search. An internal retry is exactly the double purchase this design exists to prevent.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsx(ParamField,{body:`vendorKey`,type:`string`,required:true,id:`param-vendor-key`,children:_jsx(_components.p,{children:`Your supplier identifier.`})}),`\n`,_jsx(ParamField,{body:`reference`,type:`string`,required:true,id:`param-reference`,children:_jsxs(_components.p,{children:[`Retail’s reference for this order. Store it on your order so `,_jsx(_components.a,{href:`/vendor-api/search-orders`,children:`Search orders`}),` can find it. It is the same value the `,_jsx(_components.a,{href:`/vendor-api/quote`,children:`quote`}),` carried.`]})}),`\n`,_jsx(ParamField,{body:`vendorListingId`,type:`string`,required:true,id:`param-vendor-listing-id`,children:_jsx(_components.p,{children:`The listing being bought.`})}),`\n`,_jsx(ParamField,{body:`quantity`,type:`integer`,required:true,id:`param-quantity`,children:_jsxs(_components.p,{children:[`Tickets to buy. One of the listing’s `,_jsx(_components.code,{children:`splits`}),`.`]})}),`\n`,_jsx(ParamField,{body:`unitCost`,type:`number`,required:true,id:`param-unit-cost`,children:_jsx(_components.p,{children:`The per-ticket wholesale price Retail expects to pay, from the listing. Refuse the order if your price is now higher.`})}),`\n`,_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsxs(_components.p,{children:[`ISO 4217 code for `,_jsx(_components.code,{children:`unitCost`}),`.`]})}),`\n`,_jsx(ParamField,{body:`taxSignature`,type:`string`,required:true,id:`param-tax-signature`,children:_jsx(_components.p,{children:`The signature from the quote this order was priced from. Refuse the order if it does not match: it was priced against a different quote, or none.`})}),`\n`,_jsx(ParamField,{body:`retailTax`,type:`number`,id:`param-retail-tax`,children:_jsx(_components.p,{children:`The retail sales tax from that same quote, for your order record.`})}),`\n`,_jsx(ParamField,{body:`listingSignature`,type:`string`,id:`param-listing-signature`,children:_jsx(_components.p,{children:`The price-lock token from the listing, if you issued one.`})}),`\n`,_jsx(ParamField,{body:`format`,type:`string`,default:`eticket`,id:`param-format`,children:_jsxs(_components.p,{children:[`The listing’s delivery format, so you can address the order correctly. The same values as on `,_jsx(_components.a,{href:`/vendor-api/listings`,children:`Listings`}),`. Taken from the listing at the moment the buyer paid.`]})}),`\n`,_jsxs(ParamField,{body:`shippingAddress`,type:`object`,id:`param-shipping-address`,children:[_jsxs(_components.p,{children:[`Where to courier a `,_jsx(_components.strong,{children:`physical`}),` ticket. Present only when `,_jsx(_components.code,{children:`format`}),` is `,_jsx(_components.code,{children:`physical`}),`.`]}),_jsxs(Expandable,{title:`Shipping address`,children:[_jsx(ParamField,{body:`recipientName`,type:`string`,required:true,id:`param-recipient-name`,children:`One full name. The person who can receive the parcel.`}),_jsx(ParamField,{body:`phone`,type:`string`,required:true,id:`param-phone`,children:`Contact phone for the carrier.`}),_jsx(ParamField,{body:`line1`,type:`string`,required:true,id:`param-line1`,children:`Street address.`}),_jsx(ParamField,{body:`line2`,type:`string`,id:`param-line2`,children:`Unit or apartment.`}),_jsx(ParamField,{body:`city`,type:`string`,required:true,id:`param-city`,children:`City.`}),_jsx(ParamField,{body:`state`,type:`string`,required:true,id:`param-state`,children:`State or region.`}),_jsx(ParamField,{body:`postalCode`,type:`string`,required:true,id:`param-postal-code`,children:`Postal code.`}),_jsxs(ParamField,{body:`countryCode`,type:`string`,required:true,id:`param-country-code`,children:[`ISO 3166-1 alpha-2, for example `,_jsx(_components.code,{children:`US`}),`. A code, not a country name.`]})]})]}),`\n`,_jsx(ParamField,{body:`buyerEmail`,type:`string`,id:`param-buyer-email`,children:_jsxs(_components.p,{children:[`The buyer’s own email, for a seat `,_jsx(_components.strong,{children:`transferred into their account`}),`. Present only when `,_jsx(_components.code,{children:`format`}),` is `,_jsx(_components.code,{children:`mobile_transfer`}),` or `,_jsx(_components.code,{children:`flash_seats`}),`. The box office moves the seat into the account that owns this mailbox, so it must be the buyer’s real address.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`refuse-what-you-cannot-deliver`,children:`Refuse what you cannot deliver`}),`\n`,_jsx(Warning,{children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`format: \"physical\"`}),` without `,_jsx(_components.code,{children:`shippingAddress`}),`: refuse with `,_jsx(_components.code,{children:`400`}),`.`]}),` Many systems treat a missing recipient as “ship to the buying account”, which is right for an e-ticket and wrong for a parcel: it ships to Gomry Retail, silently, and the buyer never gets a ticket.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`mobile_transfer`}),` or `,_jsx(_components.code,{children:`flash_seats`}),` without `,_jsx(_components.code,{children:`buyerEmail`}),`: refuse with `,_jsx(_components.code,{children:`400`}),`.`]}),` Never fall back to any address of your own or of Gomry’s.`]}),`\n`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`shippingAddress`}),` and `,_jsx(_components.code,{children:`buyerEmail`}),` are the only buyer data that ever reaches your integration. Pass them to your system on this order and nowhere else. Do not store them, and keep them out of logs and error reports.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`vendorOrderId`,type:`string`,required:true,id:`param-vendor-order-id`,children:_jsxs(_components.p,{children:[`Your id for the order. Retail uses it on `,_jsx(_components.a,{href:`/vendor-api/fulfilment`,children:`Fulfilment`}),` and `,_jsx(_components.a,{href:`/vendor-api/credentials`,children:`Credentials`}),`.`]})}),`\n`,_jsxs(ResponseField,{name:`state`,type:`string`,required:true,id:`param-state-1`,children:[_jsx(_components.p,{children:`The order’s state in your system right now:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pending`})}),_jsx(_components.td,{children:`Placed, waiting for the seller to accept. The normal answer when a human accepts.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`accepted`})}),_jsx(_components.td,{children:`The seller accepted. Gomry Retail now owes you for it.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rejected`})}),_jsx(_components.td,{children:`The seller refused. No ticket will be delivered.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cancelled`})}),_jsx(_components.td,{children:`Cancelled after placement.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{children:`You could not determine the state. Say so rather than guess.`})]})]})]})]}),`\n`,_jsx(ResponseField,{name:`totalCost`,type:`number`,required:true,id:`param-total-cost`,children:_jsx(_components.p,{children:`What Gomry Retail will pay for the whole order.`})}),`\n`,_jsx(ResponseField,{name:`currency`,type:`string`,required:true,id:`param-currency-1`,children:_jsxs(_components.p,{children:[`ISO 4217 code for `,_jsx(_components.code,{children:`totalCost`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`raw`,type:`any`,id:`param-raw`,children:_jsx(_components.p,{children:`Your system’s order payload, stored as evidence. Must not echo the shipping address or buyer email.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Place Order","api":"POST https://integration.example.com/api/vendor/v1/orders","playground":"none","description":"Buy a listing. The one endpoint that spends money.","href":"/vendor-api/place-order"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`place-order`,children:`Place Order`}),`\n`,_jsxs(_components.p,{children:[`Places an order for a listing. This is the endpoint that spends real money, and it is designed around one assumption: `,_jsx(_components.strong,{children:`a reply can be lost after the order was placed.`})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Two submissions with the same reference can mean two real purchases`}),` unless your system deduplicates on it. `,_jsx(_components.code,{children:`reference`}),` is a search key for reconciliation, not a guarantee. Retail calls this endpoint `,_jsx(_components.strong,{children:`once`}),` per order and never retries it.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`what-happens-when-a-call-fails`,children:`What happens when a call fails`}),`\n`,_jsxs(_components.p,{children:[`Retail cannot tell “the request never arrived” from “it arrived and the reply was lost”. So `,_jsx(_components.strong,{children:`any`}),` failure here, whether a timeout, a dropped connection or a non-2xx status, is treated the same way: the order becomes `,_jsx(_components.em,{children:`unknown`}),`, and Retail finds out what happened by calling `,_jsx(_components.a,{href:`/vendor-api/search-orders`,children:`Search orders`}),` with the reference. It only submits again if that search proves no order exists.`]}),`\n`,_jsx(_components.p,{children:`That makes two things your job:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Make a replay safe.`}),` Before placing anything, check whether an order already exists for this `,_jsx(_components.code,{children:`reference`}),`. If it does, return that order with `,_jsx(_components.code,{children:`200`}),`. Never place a second one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Do not retry internally.`}),` If your upstream call fails or times out, return `,_jsx(_components.code,{children:`502`}),` and let Retail search. An internal retry is exactly the double purchase this design exists to prevent.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsx(ParamField,{body:`vendorKey`,type:`string`,required:true,id:`param-vendor-key`,children:_jsx(_components.p,{children:`Your supplier identifier.`})}),`\n`,_jsx(ParamField,{body:`reference`,type:`string`,required:true,id:`param-reference`,children:_jsxs(_components.p,{children:[`Retail’s reference for this order. Store it on your order so `,_jsx(_components.a,{href:`/vendor-api/search-orders`,children:`Search orders`}),` can find it. It is the same value the `,_jsx(_components.a,{href:`/vendor-api/quote`,children:`quote`}),` carried.`]})}),`\n`,_jsx(ParamField,{body:`vendorListingId`,type:`string`,required:true,id:`param-vendor-listing-id`,children:_jsx(_components.p,{children:`The listing being bought.`})}),`\n`,_jsx(ParamField,{body:`quantity`,type:`integer`,required:true,id:`param-quantity`,children:_jsxs(_components.p,{children:[`Tickets to buy. One of the listing’s `,_jsx(_components.code,{children:`splits`}),`.`]})}),`\n`,_jsx(ParamField,{body:`unitCost`,type:`number`,required:true,id:`param-unit-cost`,children:_jsx(_components.p,{children:`The per-ticket wholesale price Retail expects to pay, from the listing. Refuse the order if your price is now higher.`})}),`\n`,_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsxs(_components.p,{children:[`ISO 4217 code for `,_jsx(_components.code,{children:`unitCost`}),`.`]})}),`\n`,_jsx(ParamField,{body:`taxSignature`,type:`string`,required:true,id:`param-tax-signature`,children:_jsx(_components.p,{children:`The signature from the quote this order was priced from. Refuse the order if it does not match: it was priced against a different quote, or none.`})}),`\n`,_jsx(ParamField,{body:`retailTax`,type:`number`,id:`param-retail-tax`,children:_jsx(_components.p,{children:`The retail sales tax from that same quote, for your order record.`})}),`\n`,_jsx(ParamField,{body:`listingSignature`,type:`string`,id:`param-listing-signature`,children:_jsx(_components.p,{children:`The price-lock token from the listing, if you issued one.`})}),`\n`,_jsx(ParamField,{body:`format`,type:`string`,default:`eticket`,id:`param-format`,children:_jsxs(_components.p,{children:[`The listing’s delivery format, so you can address the order correctly. The same values as on `,_jsx(_components.a,{href:`/vendor-api/listings`,children:`Listings`}),`. Taken from the listing at the moment the buyer paid.`]})}),`\n`,_jsxs(ParamField,{body:`shippingAddress`,type:`object`,id:`param-shipping-address`,children:[_jsxs(_components.p,{children:[`Where to courier a `,_jsx(_components.strong,{children:`physical`}),` ticket. Present only when `,_jsx(_components.code,{children:`format`}),` is `,_jsx(_components.code,{children:`physical`}),`.`]}),_jsxs(Expandable,{title:`Shipping address`,children:[_jsx(ParamField,{body:`recipientName`,type:`string`,required:true,id:`param-recipient-name`,children:`One full name. The person who can receive the parcel.`}),_jsx(ParamField,{body:`phone`,type:`string`,required:true,id:`param-phone`,children:`Contact phone for the carrier.`}),_jsx(ParamField,{body:`line1`,type:`string`,required:true,id:`param-line1`,children:`Street address.`}),_jsx(ParamField,{body:`line2`,type:`string`,id:`param-line2`,children:`Unit or apartment.`}),_jsx(ParamField,{body:`city`,type:`string`,required:true,id:`param-city`,children:`City.`}),_jsx(ParamField,{body:`state`,type:`string`,required:true,id:`param-state`,children:`State or region.`}),_jsx(ParamField,{body:`postalCode`,type:`string`,required:true,id:`param-postal-code`,children:`Postal code.`}),_jsxs(ParamField,{body:`countryCode`,type:`string`,required:true,id:`param-country-code`,children:[`ISO 3166-1 alpha-2, for example `,_jsx(_components.code,{children:`US`}),`. A code, not a country name.`]})]})]}),`\n`,_jsx(ParamField,{body:`buyerEmail`,type:`string`,id:`param-buyer-email`,children:_jsxs(_components.p,{children:[`The buyer’s own email, for a seat `,_jsx(_components.strong,{children:`transferred into their account`}),`. Present only when `,_jsx(_components.code,{children:`format`}),` is `,_jsx(_components.code,{children:`mobile_transfer`}),` or `,_jsx(_components.code,{children:`flash_seats`}),`. The box office moves the seat into the account that owns this mailbox, so it must be the buyer’s real address.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`refuse-what-you-cannot-deliver`,children:`Refuse what you cannot deliver`}),`\n`,_jsx(Warning,{children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`format: \"physical\"`}),` without `,_jsx(_components.code,{children:`shippingAddress`}),`: refuse with `,_jsx(_components.code,{children:`400`}),`.`]}),` Many systems treat a missing recipient as “ship to the buying account”, which is right for an e-ticket and wrong for a parcel: it ships to Gomry Retail, silently, and the buyer never gets a ticket.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`mobile_transfer`}),` or `,_jsx(_components.code,{children:`flash_seats`}),` without `,_jsx(_components.code,{children:`buyerEmail`}),`: refuse with `,_jsx(_components.code,{children:`400`}),`.`]}),` Never fall back to any address of your own or of Gomry’s.`]}),`\n`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`shippingAddress`}),` and `,_jsx(_components.code,{children:`buyerEmail`}),` are the only buyer data that ever reaches your integration. Pass them to your system on this order and nowhere else. Do not store them, and keep them out of logs and error reports.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`vendorOrderId`,type:`string`,required:true,id:`param-vendor-order-id`,children:_jsxs(_components.p,{children:[`Your id for the order. Retail uses it on `,_jsx(_components.a,{href:`/vendor-api/fulfilment`,children:`Fulfilment`}),` and `,_jsx(_components.a,{href:`/vendor-api/credentials`,children:`Credentials`}),`.`]})}),`\n`,_jsxs(ResponseField,{name:`state`,type:`string`,required:true,id:`param-state-1`,children:[_jsx(_components.p,{children:`The order’s state in your system right now:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pending`})}),_jsx(_components.td,{children:`Placed, waiting for the seller to accept. The normal answer when a human accepts.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`accepted`})}),_jsx(_components.td,{children:`The seller accepted. Gomry Retail now owes you for it.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rejected`})}),_jsx(_components.td,{children:`The seller refused. No ticket will be delivered.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cancelled`})}),_jsx(_components.td,{children:`Cancelled after placement.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{children:`You could not determine the state. Say so rather than guess.`})]})]})]})]}),`\n`,_jsx(ResponseField,{name:`totalCost`,type:`number`,required:true,id:`param-total-cost`,children:_jsx(_components.p,{children:`What Gomry Retail will pay for the whole order.`})}),`\n`,_jsx(ResponseField,{name:`currency`,type:`string`,required:true,id:`param-currency-1`,children:_jsxs(_components.p,{children:[`ISO 4217 code for `,_jsx(_components.code,{children:`totalCost`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`raw`,type:`any`,id:`param-raw`,children:_jsx(_components.p,{children:`Your system’s order payload, stored as evidence. Must not echo the shipping address or buyer email.`})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`15`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`15`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X POST `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://integration.example.com/api/vendor/v1/orders\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"X-API-Key: $GOMRY_RETAIL_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"vendorKey\": \"acme\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"reference\": \"8b1f3c5e2a9d4f7081c6e2b4a0d9f3e1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"vendorListingId\": \"tg_88412093\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quantity\": 2,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"unitCost\": 96.0,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"currency\": \"USD\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"taxSignature\": \"lock_7d2e91c4\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"retailTax\": 17.76,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"listingSignature\": \"sig_5f1c2a\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"format\": \"eticket\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"vendorOrderId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ord_551204\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"state\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pending\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"totalCost\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`192.0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USD\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`400`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"validation_error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"taxSignature does not match the quote for this reference: re-quote before ordering\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`502`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"integration_error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Upstream order call timed out after 15000ms\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Place Order","api":"POST https://integration.example.com/api/vendor/v1/orders","playground":"none","description":"Buy a listing. The one endpoint that spends money.","href":"/vendor-api/place-order"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Place Order","slug":"place-order","depth":1,"children":[]},{"title":"What happens when a call fails","slug":"what-happens-when-a-call-fails","depth":2,"children":[]},{"title":"Body","slug":"body","depth":2,"children":[{"title":"Refuse what you cannot deliver","slug":"refuse-what-you-cannot-deliver","depth":3,"children":[]}]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"15\">\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -X POST \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://integration.example.com/api/vendor/v1/orders\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -H \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"X-API-Key: $GOMRY_RETAIL_API_KEY\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -H \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -d \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"vendorKey\": \"acme\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"reference\": \"8b1f3c5e2a9d4f7081c6e2b4a0d9f3e1\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"vendorListingId\": \"tg_88412093\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"quantity\": 2,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"unitCost\": 96.0,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"currency\": \"USD\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"taxSignature\": \"lock_7d2e91c4\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"retailTax\": 17.76,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"listingSignature\": \"sig_5f1c2a\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"format\": \"eticket\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"6\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"vendorOrderId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ord_551204\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"state\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"pending\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"totalCost\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">192.0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"USD\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"6\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"validation_error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"taxSignature does not match the quote for this reference: re-quote before ordering\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"502","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"6\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"integration_error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Upstream order call timed out after 15000ms\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Place Order","path":"/api/vendor/v1/orders","servers":[{"url":"https://integration.example.com"}],"method":"post","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"X-API-KEY":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"vendorKey":[{"type":"string","description":"Your supplier identifier.","required":true}],"reference":[{"type":"string","description":"Retail’s reference for this order. Store it on your order so Search orders can find it. It is the same value the quote carried.","required":true}],"vendorListingId":[{"type":"string","description":"The listing being bought.","required":true}],"quantity":[{"type":"integer","description":"Tickets to buy. One of the listing’s `splits` .","required":true}],"unitCost":[{"type":"number","description":"The per-ticket wholesale price Retail expects to pay, from the listing. Refuse the order if your price is now higher.","required":true}],"currency":[{"type":"string","description":"ISO 4217 code for `unitCost` .","required":true}],"taxSignature":[{"type":"string","description":"The signature from the quote this order was priced from. Refuse the order if it does not match: it was priced against a different quote, or none.","required":true}],"retailTax":[{"type":"number","description":"The retail sales tax from that same quote, for your order record."}],"listingSignature":[{"type":"string","description":"The price-lock token from the listing, if you issued one."}],"format":[{"type":"string","description":"The listing’s delivery format, so you can address the order correctly. The same values as on Listings . Taken from the listing at the moment the buyer paid."}],"shippingAddress":[{"type":"object","properties":{"recipientName":[{"type":"string","description":"One full name. The person who can receive the parcel.","required":true}],"phone":[{"type":"string","description":"Contact phone for the carrier.","required":true}],"line1":[{"type":"string","description":"Street address.","required":true}],"line2":[{"type":"string","description":"Unit or apartment."}],"city":[{"type":"string","description":"City.","required":true}],"state":[{"type":"string","description":"State or region.","required":true}],"postalCode":[{"type":"string","description":"Postal code.","required":true}],"countryCode":[{"type":"string","description":"ISO 3166-1 alpha-2, for example `US` . A code, not a country name.","required":true}]},"description":"Where to courier a physical ticket. Present only when `format` is `physical` ."}],"buyerEmail":[{"type":"string","description":"The buyer’s own email, for a seat transferred into their account . Present only when `format` is `mobile_transfer` or `flash_seats` . The box office moves the seat into the account that owns this mailbox, so it must be the buyer’s real address."}]}}],"examples":{"example":{"value":{"vendorKey":"\u003cstring>","reference":"\u003cstring>","vendorListingId":"\u003cstring>","quantity":123,"unitCost":123,"currency":"\u003cstring>","taxSignature":"\u003cstring>","retailTax":123,"listingSignature":"\u003cstring>","format":"\u003cstring>","shippingAddress":{"recipientName":"\u003cstring>","phone":"\u003cstring>","line1":"\u003cstring>","line2":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","postalCode":"\u003cstring>","countryCode":"\u003cstring>"},"buyerEmail":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"vendorOrderId":[{"type":"string","description":"Your id for the order. Retail uses it on Fulfilment and Credentials .","required":true}],"state":[{"type":"string","description":"The order’s state in your system right now: Value Meaning `pending` Placed, waiting for the seller to accept. The normal answer when a human accepts. `accepted` The seller accepted. Gomry Retail now owes you for it. `rejected` The seller refused. No ticket will be delivered. `cancelled` Cancelled after placement. `unknown` You could not determine the state. Say so rather than guess.","required":true}],"totalCost":[{"type":"number","description":"What Gomry Retail will pay for the whole order.","required":true}],"currency":[{"type":"string","description":"ISO 4217 code for `totalCost` .","required":true}],"raw":[{"type":"any","description":"Your system’s order payload, stored as evidence. Must not echo the shipping address or buyer email."}]}}],"examples":{"example":{"value":{"vendorOrderId":"\u003cstring>","state":"\u003cstring>","totalCost":123,"currency":"\u003cstring>","raw":"\u003cany>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"gomry","siteName":"Gomry API","title":"Place Order - Gomry API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-01T12:48:00.185Z","originalFileLocation":"vendor-api/place-order.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Buy a listing. The one endpoint that spends money.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Gomry API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Place Order - Gomry API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Buy a listing. The one endpoint that spends money.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gomry API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gomry.com/vendor-api/place-order\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gomry.mintlify.site/_mintlify/api/og/v2?division=Purchasing\u0026amp;title=Place+Order\u0026amp;description=Buy+a+listing.+The+one+endpoint+that+spends+money.\u0026amp;theme=ca1b6992667328742845d162\u0026amp;signature=a7e69557943c08fc3d0b7643abf2138f96e02ab05d62633783586362dad42f7a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Place Order - Gomry API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Buy a listing. The one endpoint that spends money.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gomry.mintlify.site/_mintlify/api/og/v2?division=Purchasing\u0026amp;title=Place+Order\u0026amp;description=Buy+a+listing.+The+one+endpoint+that+spends+money.\u0026amp;theme=ca1b6992667328742845d162\u0026amp;signature=a7e69557943c08fc3d0b7643abf2138f96e02ab05d62633783586362dad42f7a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gomry API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gomry.com/vendor-api/place-order\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/vendor-api/place-order.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gomry.com/#organization\",\"name\":\"Gomry API\",\"url\":\"https://docs.gomry.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gomry/jDJp3Wqzn5wDGgQC/images/logo-light.png?fit=max\u0026auto=format\u0026n=jDJp3Wqzn5wDGgQC\u0026q=85\u0026s=f219d76acf24de2d111ed934cfcb6606\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gomry.com#website\",\"name\":\"Gomry API\",\"url\":\"https://docs.gomry.com\",\"publisher\":{\"@id\":\"https://docs.gomry.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gomry.com/vendor-api/place-order#webpage\",\"url\":\"https://docs.gomry.com/vendor-api/place-order\",\"name\":\"Place Order\",\"description\":\"Buy a listing. The one endpoint that spends money.\",\"dateModified\":\"2026-10-01T12:48:00.185Z\",\"isPartOf\":{\"@id\":\"https://docs.gomry.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gomry.com/vendor-api/place-order#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gomry.com/vendor-api/place-order#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Purchasing\",\"item\":\"https://docs.gomry.com/vendor-api/quote\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Place Order\",\"item\":\"https://docs.gomry.com/vendor-api/place-order\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gomry.com/vendor-api/place-order#apireference\",\"headline\":\"Place Order\",\"name\":\"Place Order\",\"description\":\"Buy a listing. The one endpoint that spends money.\",\"url\":\"https://docs.gomry.com/vendor-api/place-order\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gomry.com/vendor-api/place-order#webpage\"},\"dateModified\":\"2026-10-01T12:48:00.185Z\",\"publisher\":{\"@id\":\"https://docs.gomry.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gomry.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Gomry API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Gomry API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/vendor-api/place-order.md","siteName":"Gomry API","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","tabs":[{"tab":"Platform API","pages":[{"title":"Platform API","href":"/introduction"}]},{"tab":"Commerce API","pages":[{"title":"Commerce API","href":"/commerce/introduction"}]},{"tab":"Retail Vendor API","groups":[{"group":"Overview","pages":[{"title":"Vendor API","href":"/vendor-api/introduction"},{"title":"Authentication and Errors","href":"/vendor-api/authentication"},{"title":"Webhooks to Retail","href":"/vendor-api/webhooks"},{"title":"Going Live","href":"/vendor-api/going-live"}]},{"group":"Catalog and Listings","pages":[{"title":"Catalog","api":"GET https://integration.example.com/api/vendor/v1/catalog","playground":"none","href":"/vendor-api/catalog"},{"title":"Listings","api":"GET https://integration.example.com/api/vendor/v1/listings","playground":"none","href":"/vendor-api/listings"},{"title":"Venue Map","api":"GET https://integration.example.com/api/vendor/v1/venue-map","playground":"none","href":"/vendor-api/venue-map"}]},{"group":"Purchasing","pages":[{"title":"Quote","api":"POST https://integration.example.com/api/vendor/v1/quote","playground":"none","description":"Price a purchase, including tax on both legs, and return the signature the order must carry","href":"/vendor-api/quote"},{"title":"Place Order","api":"POST https://integration.example.com/api/vendor/v1/orders","playground":"none","href":"/vendor-api/place-order"},{"title":"Search Orders","api":"GET https://integration.example.com/api/vendor/v1/orders","playground":"none","description":"Find orders carrying Retail's reference. How Retail learns what actually happened.","href":"/vendor-api/search-orders"}]},{"group":"Delivery","pages":[{"title":"Fulfilment","api":"GET https://integration.example.com/api/vendor/v1/fulfilment","playground":"none","href":"/vendor-api/fulfilment"},{"title":"Credentials","api":"GET https://integration.example.com/api/vendor/v1/credentials","playground":"none","href":"/vendor-api/credentials"}]}]},{"tab":"Distribution API","pages":[{"title":"Distribution API","href":"/distribution-api/introduction"}]}]},{"anchor":"Support","icon":"envelope","href":"mailto:support@gomry.com"}]},"basePath":"","title":"Place Order - Gomry API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}