Wix Events v2 orders.checkout() fails with INVALID_FORM_RESPONSE for required ADDRESS_SHORT Billing Address field

Ask the community
, , , ,
1

I am building a custom Wix Studio / Velo checkout flow for Wix Events tickets. The goal is to use a custom CMS dynamic page as the frontend, while still using Wix Events for the order, payment, ticket, QR code, guest list, check-in, and invoicing.

The flow works correctly when the Wix Events registration form only requires:



First name
Last name
Email

However, as soon as I make the Wix Events Address field required, the custom checkout fails with:



INVALID_FORM_RESPONSE

This Address field must remain required because it is needed for Wix invoicing.

Current setup

I am using Wix Events v2:



import { orders, forms } from 'wix-events.v2';

Reservation works with:



await orders.createReservation(eventId, {
  ticketQuantities: [
    {
      ticketDefinitionId,
      quantity
    }
  ]
});

Checkout is being called with:



await orders.checkout(eventId, {
  reservationId,
  guests: [
    {
      form: {
        inputValues: [
          {
            inputName: "firstName",
            value: "Test"
          },
          {
            inputName: "lastName",
            value: "User"
          },
          {
            inputName: "email",
            value: "test@example.com"
          },
          {
            inputName: "address-8f0b7a4381c649fd",
            value: "Warschauer Str. 1, 10243 Berlin, Germany"
          }
        ]
      }
    }
  ]
});

The form schema from:



await forms.getForm(eventId, {});

returns the Address control as:



{
  type: "ADDRESS_SHORT",
  system: false,
  name: "address-8f0b7a4381c649fd",
  label: "Billing Address",
  inputs: [
    {
      name: "address-8f0b7a4381c649fd",
      type: "TEXT",
      array: false
    }
  ]
}

Resolved input names are:



{
  firstName: "firstName",
  lastName: "lastName",
  email: "email",
  address: "address-8f0b7a4381c649fd"
}

What has already been tested

The following reservation and checkout structure issues were resolved through Wix validation errors:



orders.createReservation() requires options.ticketQuantities
orders.checkout() requires options.guests
guests[0] requires form
form requires inputValues

The current unresolved error is still:



INVALID_FORM_RESPONSE

when the required ADDRESS_SHORT field is present.

I have tested the address field as:



{
  inputName: "address-8f0b7a4381c649fd",
  value: "Warschauer Str. 60, 10243 Berlin, Germany"
}

and:



{
  inputName: "address-8f0b7a4381c649fd",
  value: "Warschauer Str. 60, 10243 Berlin, Germany",
  values: []
}

Both fail with INVALID_FORM_RESPONSE.

My question

What is the exact payload shape required by Wix Events v2 orders.checkout() for a required Wix Events registration form field of type:



ADDRESS_SHORT

Specifically, how should this field be submitted inside:



guests[0].form.inputValues

Should the value be:



plain string
structured address object
JSON-stringified object
values array
another Wix-specific address shape

The public documentation does not appear to describe the expected inputValues format for ADDRESS_SHORT.