Validate an x402 flower-letter order and return a Florist One quote

post/api/machine/flower-letters/validate

Request

  • Base URL: https://postalform.com
  • URL: https://postalform.com/api/machine/flower-letters/validate
  • Auth: none required

Request body

request_idstring uuid required

Client-generated idempotency key. Reuse the same value and exact body after a 402 challenge.

buyer_namestring required
buyer_emailstring email required
notestring required

Message attached to the real flowers on the florist card.

zipcodestring required

Recipient delivery ZIP used for Florist One catalog totals and delivery dates.

product_codestring required

Florist One product code selected from the catalog.

delivery_datestring date required

Requested Florist One delivery date. The date is checked again after payment.

special_instructionsstring
allow_substitutionsboolean

Defaults to true.

Example request

{
  "request_id": "8c1a1b58-2c8f-4f4f-9c46-2c1ac32d7a1b",
  "buyer_name": "Agent Owner",
  "buyer_email": "owner@example.com",
  "note": "For your desk, your day, and the smile I hope this brings.",
  "zipcode": "32503",
  "product_code": "F1-509",
  "delivery_date": "2026-05-08",
  "customer": {
    "name": "Agent Owner",
    "phone": "8505550100",
    "address1": "123 Sender St",
    "city": "Pensacola",
    "state": "FL",
    "zipcode": "32503",
    "country": "US",
    "email": "owner@example.com"
  },
  "recipient": {
    "name": "Recipient Example",
    "phone": "8505550199",
    "address1": "456 Recipient Ave",
    "city": "Pensacola",
    "state": "FL",
    "zipcode": "32503",
    "country": "US"
  },
  "allow_substitutions": true
}

Response

Validation succeeded

request_idstring uuid required
request_hashstring required
order_idstring uuid nullable required
status'validated_existing_order' | 'validated_new_order' required
protocol'mpp'
methodsstring[]
product_type'flower_letter' required

Changes

No recorded changes to this operation across all 1 revision of this API.