Checkout place — Amazon Shopping UK

amazon.checkout.place

Submit a quoted Amazon checkout and reconcile the resulting order

POST /v1/operations/amazon.checkout.place

Headers

Authorization: Bearer YOUR_AJAR_API_KEY
x-amazon-token: YOUR_AMAZON_TOKEN
x-idempotency-key: YOUR_UNIQUE_ATTEMPT_KEY
Content-Type: application/json

x-idempotency-key identifies one intended action. Generate a unique value, such as crypto.randomUUID(), before sending it. Use 1–128 letters, numbers, hyphens, underscores or periods. A duplicate attempt is rejected; it does not return a cached success. If a request times out, check the provider’s state before starting a new attempt with a new key. See the idempotency guide.

Inputs

Parameter	Example type	Example value
pipeline_id	string	"p-000-0000000-0000000"
expected_address_id	string	"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
expected_payment_method_id	string	"sample-payment-method"
expected_total_minor	number	500
expected_asins	array	["B012345678"]
confirm_purchase	boolean	true

Example input

{
  "pipeline_id": "p-000-0000000-0000000",
  "expected_address_id": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  "expected_payment_method_id": "sample-payment-method",
  "expected_total_minor": 500,
  "expected_asins": [
    "B012345678"
  ],
  "confirm_purchase": true
}

Open JSON schema

Input schema

{
  "$id": "https://useajar.com/schemas/amazon/checkout-place.input.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "confirm_purchase": {
      "const": true
    },
    "expected_address_id": {
      "pattern": "^[A-Za-z0-9_-]{64}$",
      "type": "string"
    },
    "expected_asins": {
      "items": {
        "pattern": "^[A-Z0-9]{10}$",
        "type": "string"
      },
      "maxItems": 50,
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "expected_payment_method_id": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "expected_total_minor": {
      "maximum": 1000000,
      "minimum": 1,
      "type": "integer"
    },
    "pipeline_id": {
      "pattern": "^p-[0-9]{3}-[0-9]{7}-[0-9]{7}$",
      "type": "string"
    }
  },
  "required": [
    "pipeline_id",
    "expected_address_id",
    "expected_payment_method_id",
    "expected_total_minor",
    "expected_asins",
    "confirm_purchase"
  ],
  "title": "Amazon checkout-place input",
  "type": "object"
}