POST
/
groups

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
customerId
string
required

The ID of the customer. This field is required and must be a valid customer ID.

paymentIntentId
string
required

The ID of the payment intent associated with this payment group. This field is required and must be a valid payment intent ID.

orderId
string
required

The ID of the payment intent associated with this payment group. This field is required and must be a valid payment intent ID.

metadata
object

Additional metadata for the payment group. This can include any additional information needed to process the payment group.

expiresAt
string

The expiration date and time of the payment group. Must be between the minimum and maximum payment group duration.

midExpireAt
string

The midpoint date and time of the payment group for reminder purposes. Must be before the expiration date.

Response

201 - application/json
id
string
required

The id of the group.

shareId
string | null
required

The shared identifier of the group. If null, it will create a group. If not null, it will join the group.

livemode
boolean
required

Wether the order is in live mode or test mode.

organizationId
string
required

The id of the organization.

customerId
string
required

The id of the customer.

creatorEmail
string
required

The email of the creator of the group.

status
enum<string>
required

The status of the group.

Available options:
OPEN,
COMPLETED,
CANCELED,
EXPIRED
metadata
object
required

Additional metadata for the order.

expiresAt
string
required
midExpireAt
string
required
jMinus2ExpireAt
string
required
jPlus3StartAt
string
required
reminderEmailSent
enum<string>
required

The reminder email sent status of the group.

Available options:
NOT_SENT,
MIDWAY_SENT,
DAY3_SENT,
DAY2_BEFORE_END_SENT
createdAt
string
required
createdBy
string | null
required

The id of the user who created the customer.

updatedAt
string
required
updatedBy
string | null
required

The id of the user who last updated the customer.

canceledAt
string
required
completedAt
string
required