Reseller Event Data

Operations to manage reseller event data records. Scoped per reseller program; Corego is the first consumer.

List reseller event data records

get

Returns a paginated list of all reseller event data records, optionally filtered by resellerId.

Query parameters

resellerIdstringOptional

Filter records by reseller program identifier (e.g. COREGO).

pageNumberinteger · min: 1Optional

Page number for records.

Default: 1Example: 1

pageSizeinteger · min: 1 · max: 100Optional

Page size for returned records.

Default: 50Example: 50

Responses

200

Paginated list of reseller event data records.

application/json

Paginated response envelope for reseller event data list endpoints.

totalElementsintegerOptional

Total number of records matching the query.

totalPagesintegerOptional

Total number of pages available.

currentPageintegerOptional

Zero-based index of the current page.

sizeintegerOptional

Number of records per page.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

get

/reseller-event-data

GET /reseller-event-data HTTP/1.1
Host: api.verifone.com
Accept: */*

{
  "content": [
    {
      "resellerId": "text",
      "merchantRegistrationNumber": "text",
      "eventId": "text",
      "eventOrganizerId": "text",
      "eventRevenueSharePercentage": 1,
      "merchantLegalName": "text",
      "merchantVatNumber": "text",
      "servicePackage": "text",
      "eventExpiryDate": "2026-06-13T03:55:41.886Z",
      "createdUserUid": "123e4567-e89b-12d3-a456-426614174000",
      "createdBy": "text",
      "createdDate": "2026-06-13T03:55:41.886Z",
      "modifiedUserUid": "123e4567-e89b-12d3-a456-426614174000",
      "modifiedBy": "text",
      "modifiedDate": "2026-06-13T03:55:41.886Z"
    }
  ],
  "totalElements": 1,
  "totalPages": 1,
  "currentPage": 1,
  "size": 1
}

Upsert reseller event data record

post

Creates or updates a single reseller event data record. Uniqueness is determined by merchantRegistrationNumber + eventId.

Body

A reseller event data record scoped to a reseller program and merchant.

resellerIdstringOptional

Reseller program identifier (e.g. COREGO). Scopes the record to a specific reseller.

merchantRegistrationNumberstringRequired

Merchant registration/organisation number. Used to match against order data at submission time.

eventIdstringRequired

TCS-generated event identifier.

eventOrganizerIdstringRequired

Merchant agreement reference of the event organizer in TCS.

eventRevenueSharePercentagenumberRequired

Commission percentage as a decimal number (e.g. 20 or 12.5 meaning 20% or 12.5%). Stored as a percentage value. Conversion is the caller's responsibility: TCS requires basis points (multiply by 100); display requires a % suffix.

merchantLegalNamestringOptional

Legal name of the merchant.

merchantVatNumberstringOptional

VAT registration number of the merchant.

servicePackagestringOptional

Portfolio service package identifier.

eventExpiryDatestring · date-timeOptional

Date and time when the event expires.

createdUserUidstring · uuidRead-onlyOptional

User ID of the user who created this record.

createdBystringRead-onlyOptional

Display name of the user who created this record.

createdDatestring · date-timeRead-onlyOptional

Timestamp when this record was created.

modifiedUserUidstring · uuidRead-onlyOptional

User ID of the user who last modified this record.

modifiedBystringRead-onlyOptional

Display name of the user who last modified this record.

modifiedDatestring · date-timeRead-onlyOptional

Timestamp when this record was last modified.

Responses

200

Record upserted successfully.

application/json

A reseller event data record scoped to a reseller program and merchant.

resellerIdstringOptional

Reseller program identifier (e.g. COREGO). Scopes the record to a specific reseller.

merchantRegistrationNumberstringRequired

Merchant registration/organisation number. Used to match against order data at submission time.

eventIdstringRequired

TCS-generated event identifier.

eventOrganizerIdstringRequired

Merchant agreement reference of the event organizer in TCS.

eventRevenueSharePercentagenumberRequired

merchantLegalNamestringOptional

Legal name of the merchant.

merchantVatNumberstringOptional

VAT registration number of the merchant.

servicePackagestringOptional

Portfolio service package identifier.

eventExpiryDatestring · date-timeOptional

Date and time when the event expires.

createdUserUidstring · uuidRead-onlyOptional

User ID of the user who created this record.

createdBystringRead-onlyOptional

Display name of the user who created this record.

createdDatestring · date-timeRead-onlyOptional

Timestamp when this record was created.

modifiedUserUidstring · uuidRead-onlyOptional

User ID of the user who last modified this record.

modifiedBystringRead-onlyOptional

Display name of the user who last modified this record.

modifiedDatestring · date-timeRead-onlyOptional

Timestamp when this record was last modified.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

post

/reseller-event-data

POST /reseller-event-data HTTP/1.1
Host: api.verifone.com
Content-Type: application/json
Accept: */*
Content-Length: 255

{
  "resellerId": "text",
  "merchantRegistrationNumber": "text",
  "eventId": "text",
  "eventOrganizerId": "text",
  "eventRevenueSharePercentage": 1,
  "merchantLegalName": "text",
  "merchantVatNumber": "text",
  "servicePackage": "text",
  "eventExpiryDate": "2026-06-13T03:55:41.886Z"
}

{
  "resellerId": "text",
  "merchantRegistrationNumber": "text",
  "eventId": "text",
  "eventOrganizerId": "text",
  "eventRevenueSharePercentage": 1,
  "merchantLegalName": "text",
  "merchantVatNumber": "text",
  "servicePackage": "text",
  "eventExpiryDate": "2026-06-13T03:55:41.886Z",
  "createdUserUid": "123e4567-e89b-12d3-a456-426614174000",
  "createdBy": "text",
  "createdDate": "2026-06-13T03:55:41.886Z",
  "modifiedUserUid": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedBy": "text",
  "modifiedDate": "2026-06-13T03:55:41.886Z"
}

Bulk upsert reseller event data records

post

Creates or updates an array of reseller event data records. Uniqueness per record is determined by merchantRegistrationNumber + eventId. Response includes per-record success/failure status.

Bodyobject[]

A reseller event data record scoped to a reseller program and merchant.

resellerIdstringOptional

Reseller program identifier (e.g. COREGO). Scopes the record to a specific reseller.

merchantRegistrationNumberstringRequired

Merchant registration/organisation number. Used to match against order data at submission time.

eventIdstringRequired

TCS-generated event identifier.

eventOrganizerIdstringRequired

Merchant agreement reference of the event organizer in TCS.

eventRevenueSharePercentagenumberRequired

merchantLegalNamestringOptional

Legal name of the merchant.

merchantVatNumberstringOptional

VAT registration number of the merchant.

servicePackagestringOptional

Portfolio service package identifier.

eventExpiryDatestring · date-timeOptional

Date and time when the event expires.

createdUserUidstring · uuidRead-onlyOptional

User ID of the user who created this record.

createdBystringRead-onlyOptional

Display name of the user who created this record.

createdDatestring · date-timeRead-onlyOptional

Timestamp when this record was created.

modifiedUserUidstring · uuidRead-onlyOptional

User ID of the user who last modified this record.

modifiedBystringRead-onlyOptional

Display name of the user who last modified this record.

modifiedDatestring · date-timeRead-onlyOptional

Timestamp when this record was last modified.

Responses

200

Bulk upsert completed. Inspect per-record results for individual failures.

application/json

Per-record result for bulk upsert, update, and delete operations.

merchantRegistrationNumberstringRequired

Merchant registration number of the record this result refers to.

eventIdstringRequired

Event identifier of the record this result refers to.

successbooleanRequired

Whether the operation succeeded for this record.

errorMessagestringOptional

Error detail when success is false. Omitted on success.

modifiedDatestring · date-timeRead-onlyOptional

Timestamp when the record was last modified. Present on success.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

post

/reseller-event-data/bulk

POST /reseller-event-data/bulk HTTP/1.1
Host: api.verifone.com
Content-Type: application/json
Accept: */*
Content-Length: 257

[
  {
    "resellerId": "text",
    "merchantRegistrationNumber": "text",
    "eventId": "text",
    "eventOrganizerId": "text",
    "eventRevenueSharePercentage": 1,
    "merchantLegalName": "text",
    "merchantVatNumber": "text",
    "servicePackage": "text",
    "eventExpiryDate": "2026-06-13T03:55:41.886Z"
  }
]

[
  {
    "merchantRegistrationNumber": "text",
    "eventId": "text",
    "success": true,
    "errorMessage": "text",
    "modifiedDate": "2026-06-13T03:55:41.886Z"
  }
]

Bulk update eventRevenueSharePercentage

put

Updates eventRevenueSharePercentage for an array of records identified by merchantRegistrationNumber + eventId. Response includes per-record success/failure status.

Bodyobject[]

Single item in a bulk update request, identifying the record and providing the updated revenue share percentage.

merchantRegistrationNumberstringRequired

Merchant registration number identifying the record to update.

eventIdstringRequired

Event identifier identifying the record to update.

eventRevenueSharePercentagenumberRequired

Updated commission percentage as a decimal number (e.g. 20 or 12.5 meaning 20% or 12.5%). Conversion is the caller's responsibility: TCS requires basis points (multiply by 100); display requires a % suffix.

Responses

200

Bulk update completed. Inspect per-record results for individual failures.

application/json

Per-record result for bulk upsert, update, and delete operations.

merchantRegistrationNumberstringRequired

Merchant registration number of the record this result refers to.

eventIdstringRequired

Event identifier of the record this result refers to.

successbooleanRequired

Whether the operation succeeded for this record.

errorMessagestringOptional

Error detail when success is false. Omitted on success.

modifiedDatestring · date-timeRead-onlyOptional

Timestamp when the record was last modified. Present on success.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

404

Not Found Request

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

put

/reseller-event-data/bulk

PUT /reseller-event-data/bulk HTTP/1.1
Host: api.verifone.com
Content-Type: application/json
Accept: */*
Content-Length: 88

[
  {
    "merchantRegistrationNumber": "text",
    "eventId": "text",
    "eventRevenueSharePercentage": 1
  }
]

[
  {
    "merchantRegistrationNumber": "text",
    "eventId": "text",
    "success": true,
    "errorMessage": "text",
    "modifiedDate": "2026-06-13T03:55:41.886Z"
  }
]

Bulk delete reseller event data records

delete

Deletes an array of records identified by merchantRegistrationNumber + eventId. Missing individual records are non-fatal — reported per-record in the response with success=false, but the overall response is still 200.

Bodyobject[]

Single item in a bulk delete request, identifying the record to delete.

merchantRegistrationNumberstringRequired

Merchant registration number identifying the record to delete.

eventIdstringRequired

Event identifier identifying the record to delete.

Responses

200

Bulk delete completed. Inspect per-record results for individual failures. Missing records are non-fatal.

application/json

Per-record result for bulk upsert, update, and delete operations.

merchantRegistrationNumberstringRequired

Merchant registration number of the record this result refers to.

eventIdstringRequired

Event identifier of the record this result refers to.

successbooleanRequired

Whether the operation succeeded for this record.

errorMessagestringOptional

Error detail when success is false. Omitted on success.

modifiedDatestring · date-timeRead-onlyOptional

Timestamp when the record was last modified. Present on success.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

delete

/reseller-event-data/bulk

DELETE /reseller-event-data/bulk HTTP/1.1
Host: api.verifone.com
Content-Type: application/json
Accept: */*
Content-Length: 56

[
  {
    "merchantRegistrationNumber": "text",
    "eventId": "text"
  }
]

[
  {
    "merchantRegistrationNumber": "text",
    "eventId": "text",
    "success": true,
    "errorMessage": "text",
    "modifiedDate": "2026-06-13T03:55:41.886Z"
  }
]

Get all event records for a merchant

get

Returns a paginated list of all reseller event data records for the given merchant registration number.

Path parameters

merchantRegistrationNumberstringRequired

Merchant registration/organisation number.

Query parameters

pageNumberinteger · min: 1Optional

Page number for records.

Default: 1Example: 1

pageSizeinteger · min: 1 · max: 100Optional

Page size for returned records.

Default: 50Example: 50

Responses

200

Paginated list of event records for the merchant.

application/json

Paginated response envelope for reseller event data list endpoints.

totalElementsintegerOptional

Total number of records matching the query.

totalPagesintegerOptional

Total number of pages available.

currentPageintegerOptional

Zero-based index of the current page.

sizeintegerOptional

Number of records per page.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

404

Not Found Request

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

get

/reseller-event-data/{merchantRegistrationNumber}

GET /reseller-event-data/{merchantRegistrationNumber} HTTP/1.1
Host: api.verifone.com
Accept: */*

{
  "content": [
    {
      "resellerId": "text",
      "merchantRegistrationNumber": "text",
      "eventId": "text",
      "eventOrganizerId": "text",
      "eventRevenueSharePercentage": 1,
      "merchantLegalName": "text",
      "merchantVatNumber": "text",
      "servicePackage": "text",
      "eventExpiryDate": "2026-06-13T03:55:41.886Z",
      "createdUserUid": "123e4567-e89b-12d3-a456-426614174000",
      "createdBy": "text",
      "createdDate": "2026-06-13T03:55:41.886Z",
      "modifiedUserUid": "123e4567-e89b-12d3-a456-426614174000",
      "modifiedBy": "text",
      "modifiedDate": "2026-06-13T03:55:41.886Z"
    }
  ],
  "totalElements": 1,
  "totalPages": 1,
  "currentPage": 1,
  "size": 1
}

Get a single reseller event data record

get

Returns a single reseller event data record identified by merchantRegistrationNumber and eventId. Called by order-service at order submission time.

Path parameters

merchantRegistrationNumberstringRequired

Merchant registration/organisation number.

eventIdstringRequired

TCS-generated event identifier.

Responses

200

Reseller event data record found.

application/json

A reseller event data record scoped to a reseller program and merchant.

resellerIdstringOptional

Reseller program identifier (e.g. COREGO). Scopes the record to a specific reseller.

merchantRegistrationNumberstringRequired

Merchant registration/organisation number. Used to match against order data at submission time.

eventIdstringRequired

TCS-generated event identifier.

eventOrganizerIdstringRequired

Merchant agreement reference of the event organizer in TCS.

eventRevenueSharePercentagenumberRequired

merchantLegalNamestringOptional

Legal name of the merchant.

merchantVatNumberstringOptional

VAT registration number of the merchant.

servicePackagestringOptional

Portfolio service package identifier.

eventExpiryDatestring · date-timeOptional

Date and time when the event expires.

createdUserUidstring · uuidRead-onlyOptional

User ID of the user who created this record.

createdBystringRead-onlyOptional

Display name of the user who created this record.

createdDatestring · date-timeRead-onlyOptional

Timestamp when this record was created.

modifiedUserUidstring · uuidRead-onlyOptional

User ID of the user who last modified this record.

modifiedBystringRead-onlyOptional

Display name of the user who last modified this record.

modifiedDatestring · date-timeRead-onlyOptional

Timestamp when this record was last modified.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

404

Not Found Request

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

get

/reseller-event-data/{merchantRegistrationNumber}/event/{eventId}

GET /reseller-event-data/{merchantRegistrationNumber}/event/{eventId} HTTP/1.1
Host: api.verifone.com
Accept: */*

{
  "resellerId": "text",
  "merchantRegistrationNumber": "text",
  "eventId": "text",
  "eventOrganizerId": "text",
  "eventRevenueSharePercentage": 1,
  "merchantLegalName": "text",
  "merchantVatNumber": "text",
  "servicePackage": "text",
  "eventExpiryDate": "2026-06-13T03:55:41.886Z",
  "createdUserUid": "123e4567-e89b-12d3-a456-426614174000",
  "createdBy": "text",
  "createdDate": "2026-06-13T03:55:41.886Z",
  "modifiedUserUid": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedBy": "text",
  "modifiedDate": "2026-06-13T03:55:41.886Z"
}

Update eventRevenueSharePercentage for a single record

put

Updates the eventRevenueSharePercentage field of the record identified by merchantRegistrationNumber and eventId.

Path parameters

merchantRegistrationNumberstringRequired

Merchant registration/organisation number.

eventIdstringRequired

TCS-generated event identifier.

Body

Request body for updating the revenue share percentage of a single reseller event record.

eventRevenueSharePercentagenumberRequired

eventExpiryDatestring · date-timeOptional

Date and time when the event expires.

Responses

200

Record updated successfully.

application/json

A reseller event data record scoped to a reseller program and merchant.

resellerIdstringOptional

Reseller program identifier (e.g. COREGO). Scopes the record to a specific reseller.

merchantRegistrationNumberstringRequired

Merchant registration/organisation number. Used to match against order data at submission time.

eventIdstringRequired

TCS-generated event identifier.

eventOrganizerIdstringRequired

Merchant agreement reference of the event organizer in TCS.

eventRevenueSharePercentagenumberRequired

merchantLegalNamestringOptional

Legal name of the merchant.

merchantVatNumberstringOptional

VAT registration number of the merchant.

servicePackagestringOptional

Portfolio service package identifier.

eventExpiryDatestring · date-timeOptional

Date and time when the event expires.

createdUserUidstring · uuidRead-onlyOptional

User ID of the user who created this record.

createdBystringRead-onlyOptional

Display name of the user who created this record.

createdDatestring · date-timeRead-onlyOptional

Timestamp when this record was created.

modifiedUserUidstring · uuidRead-onlyOptional

User ID of the user who last modified this record.

modifiedBystringRead-onlyOptional

Display name of the user who last modified this record.

modifiedDatestring · date-timeRead-onlyOptional

Timestamp when this record was last modified.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

404

Not Found Request

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

put

/reseller-event-data/{merchantRegistrationNumber}/event/{eventId}

PUT /reseller-event-data/{merchantRegistrationNumber}/event/{eventId} HTTP/1.1
Host: api.verifone.com
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "eventRevenueSharePercentage": 1,
  "eventExpiryDate": "2026-06-13T03:55:41.886Z"
}

{
  "resellerId": "text",
  "merchantRegistrationNumber": "text",
  "eventId": "text",
  "eventOrganizerId": "text",
  "eventRevenueSharePercentage": 1,
  "merchantLegalName": "text",
  "merchantVatNumber": "text",
  "servicePackage": "text",
  "eventExpiryDate": "2026-06-13T03:55:41.886Z",
  "createdUserUid": "123e4567-e89b-12d3-a456-426614174000",
  "createdBy": "text",
  "createdDate": "2026-06-13T03:55:41.886Z",
  "modifiedUserUid": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedBy": "text",
  "modifiedDate": "2026-06-13T03:55:41.886Z"
}

Delete a single reseller event data record

delete

Deletes the reseller event data record identified by merchantRegistrationNumber and eventId.

Path parameters

merchantRegistrationNumberstringRequired

Merchant registration/organisation number.

eventIdstringRequired

TCS-generated event identifier.

Responses

204

Record deleted successfully.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

404

Not Found Request

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

delete

/reseller-event-data/{merchantRegistrationNumber}/event/{eventId}

DELETE /reseller-event-data/{merchantRegistrationNumber}/event/{eventId} HTTP/1.1
Host: api.verifone.com
Accept: */*

No content

PreviousMerchant Orders Documentation

Last updated 10 days ago

Was this helpful?