PATCH
/
groups
/
{id}
curl --request PATCH \
  --url https://api.kohortpay.com/groups/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "metadata": {
    "order_id": "ord_1JYLo8KerLxWZaQtys6ZQ1xT"
  },
  "creatorEmail": "[email protected]"
}'
{
  "id": "ord_1234567890",
  "shareId": "KHT-XXXXXXXX",
  "livemode": true,
  "organizationId": "org_1234567890",
  "customerId": "cus_1234567890",
  "creatorEmail": "[email protected]",
  "status": "COMPLETED",
  "metadata": {
    "basket_id": "1JYLo8KerLxWZaQtys6ZQ1xS"
  },
  "expiresAt": "2021-07-22T00:00:00.000Z",
  "midExpireAt": "2021-07-22T00:00:00.000Z",
  "jMinus2ExpireAt": "2021-07-22T00:00:00.000Z",
  "jPlus3StartAt": "2021-07-22T00:00:00.000Z",
  "reminderEmailSent": "NOT_SENT",
  "createdAt": "2021-07-22T00:00:00.000Z",
  "createdBy": "usr_1234567890",
  "updatedAt": "2021-07-22T00:00:00.000Z",
  "updatedBy": "usr_1234567890",
  "canceledAt": "2021-07-22T00:00:00.000Z",
  "completedAt": "2021-07-22T00:00:00.000Z"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Unique group ID

Body

application/json
​
metadata
object
required

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

Example:
{
  "order_id": "ord_1JYLo8KerLxWZaQtys6ZQ1xT"
}
​
creatorEmail
string

Email of the creator of the payment group. This field is optional and should be a valid email address.

Example:

"[email protected]"

Response

200 - application/json
Group successfully updated.
​
id
string
required

The id of the group.

Example:

"ord_1234567890"

​
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.

Example:

"KHT-XXXXXXXX"

​
livemode
boolean
required

Wether the order is in live mode or test mode.

Example:

true

​
organizationId
string
required

The id of the organization.

Example:

"org_1234567890"

​
customerId
string
required

The id of the customer.

Example:

"cus_1234567890"

​
creatorEmail
string
required

The email of the creator of the group.

Example:

"[email protected]"

​
status
enum<string>
required

The status of the group.

Available options:
OPEN,
COMPLETED,
CANCELED,
EXPIRED
Example:

"COMPLETED"

​
metadata
object
required

Additional metadata for the order.

Example:
{ "basket_id": "1JYLo8KerLxWZaQtys6ZQ1xS" }
​
expiresAt
string
required
Example:

"2021-07-22T00:00:00.000Z"

​
midExpireAt
string
required
Example:

"2021-07-22T00:00:00.000Z"

​
jMinus2ExpireAt
string
required
Example:

"2021-07-22T00:00:00.000Z"

​
jPlus3StartAt
string
required
Example:

"2021-07-22T00:00:00.000Z"

​
reminderEmailSent
enum<string>
required

The reminder email sent status of the group.

Available options:
NOT_SENT,
MIDWAY_SENT,
DAY3_SENT,
DAY2_BEFORE_END_SENT
Example:

"NOT_SENT"

​
createdAt
string
required
Example:

"2021-07-22T00:00:00.000Z"

​
createdBy
string | null
required

The id of the user who created the customer.

Example:

"usr_1234567890"

​
updatedAt
string
required
Example:

"2021-07-22T00:00:00.000Z"

​
updatedBy
string | null
required

The id of the user who last updated the customer.

Example:

"usr_1234567890"

​
canceledAt
string
required
Example:

"2021-07-22T00:00:00.000Z"

​
completedAt
string
required
Example:

"2021-07-22T00:00:00.000Z"

Get a groupCancel a group